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Introduction 


This document describes the contents of the SunUNIXt 2.3 incremental software 
release; gives instructions for installing the 2.3 release tape on the systems 
currently running the Sun UNIX version 2.0,2.1, or 2.2 releases; discusses, 
briefly, the major software changes between each of theses releases including 
major bug fixes and enhancements; and finally, includes documentation - errata 
pages and new insert pages for your 2.0, 2.1, and 2.2 manuals -- which reflects 
these major changes. 

A major feature of Release 2.3 is the new SunCGI Reference Manual (Part 
number 800-1381). This is a complete revision of the Programmer’s Reference 
Manual for SunCGI. This new manual incorporates all bug fixes and enhance¬ 
ments from previous releases as well as new features implemented since those 
releases. 

1.1, Summary of Contents Chapter 1: Introduction 

General introduction. 

Chapter 2: Installing the 2.3 Release 

Provides instructions for installing 2.3 on systems currently running the Sun 
2.0, 2.1, or 2.2 Release software. 

Chapter 3; the New Graphics Processor and Graphics Buffer Options for the 
Sun2/160 

Describes the contents of Release 2.1 which exclusively supported the 
Sun2/160 Color Workstation with the new Graphics Processor and Graphics 
Buffer options. 

Chapter 4: Changes from the 2.1 Release Software 

Discusses the differences between Releases 2.1 and 2.2: fixes and enhance¬ 
ments. 

Chapter 5: Changes from the 2.2 Release Software 

Discusses the differences between Releases 2.2 and 2.3: bug fixes and 
enhancements. 


t UNIX is a trademark of AT&T Bell Laboratories. 
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1.2. Supporting 
Documentation 


Chapter 6; Errata Pages for 2.0 Manuals 

Appendix A: Appendix H for the Programmer’s Reference Manual for SunWin- 
dows 

Appendix A: Contents of get_arch_fYi\i 
Appendix B: Optional Software for Release 2.3 
Appendix C: Insert Pages for 2.0 Reference Manuals 

Appendix H: Appendix H for the Programmer’s Reference Manual for SunWin- 
dows 

The following manuals are useful for the installation procedures for Release 2,2. 

[ 1 ] System Administration for the Sun-2 Workstation 
(Part Number: 800-1150). 

[2] Commands Reference Manual for the Sun Workstation 
(Part Number: 800-1172), 

[3] Installing UNIX on the Sun Workstation 
(Part Number: 800-1158). 

[4] Hardware Installation Manual for the Sun-21160 Color SunStation and 
Sun-21130 SunStation 

(Part Number: 800-1144). 

[5] Sun-21160 Diagnostic Manual 
(Part Number: 800-1236). 

[6] SunCGI Reference Manual for the 2.3 Release 
(Part Number: 800-1381). 


0 ' 
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Installing the 2.3 Release 




In this chapter, we give you directions for installing the Sun 2.3 incremental 
release software on a Sun system currently running 2:0, 2.1. or 2.2 Releases. 

The directions assume that you are working with the incremental release software 
on either 1/4" or 1/2" tape, and support installation on 

□ Standalone machines with local tape drive and disk which can read in the 
distribution tape via the local tape drive 

□ Machines with a local disk, but no local tape drive, that are on a network. 
Such machines us the tap e drive on another machine (called remote Jiost or 
server_name in the procedures) to read the tape 

□ Server machines with local tape and disk with diskless clients, which will 
use the local drive to install both the server and its clients 

Before you begin, there are several important things you need to be aware of: 

D You must have at least 508 KBytes of disk space on your root partition and 
26 KBytes available on your usr partition to do this installation. If you wish 
to load the optional software included on the tape (manual pages and 
demonstration executables and source), allow at least another 991 IKBytes 
on lusr (this includes 22 KBytes for the manual pages, 3915 KBytes for the 
demos and 485 KBytes for the games). 

The dfiX) command displays information about space available in each file 
system. You should use this command before installing the 2.3 Release 
software to make sure that there is enough disk space available for it. For 
example: 

gaia% df 


' Filesystem 

kbytes 

used 

avail 

capacity 

Mounted on 

/dev/xyOa 

7437 

5470 

1223 

82% 

/ 

/dev/xyOh 

148455 

128709 

4900 

96% 

/usr 

/dev/xyOg 

117327 

66896 

38698 

63% 

/usr/misc 


{and so on ] 

In this example, the /usr file system has 4.9 MBytes of disk space available. 

□ If you are installing a new disk you must follow the directions in "Sun-21160 
Diagnostic Manual" (Part Number: 800-1236) for formatting and labeling it. 
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□ We recommend that you install this release in single user mode. If you do 
not you will be unable to upgrade the following four programs: 
/etc/inetd, /etc/ypbind, /usr/etc/rpc .mountd, and 
/usr/lib/lpd. These are multi-user mode processes. You can not 
overwrite existing active processes. 

□ This release is for installation only on systems running the Sun version 2.0, 

2.1, or 2.2 Release software. This release is incremental in the sense that 
you do not need to re-install the complete operating system. 

o This release is intended for installation as a package; you must install the 
entire release. Sun will not provide direct support for users who wish to 
install selected portions of the release software. 

0 You can "un-install" this release if you have to. A facility has been provided 
with the release for backing out changes. In most circumstances, you should 
not find this necessary; however, if you do, please inform Sun Microsystems 
Technical Support — we’d like to know what went wrong. 

□ You must build and install a new operating system kernel to complete the 
installation of the 2.3 release. 

□ BACK-UP YOUR SYSTEM BEFORE BEGINNING INSTALLATION. 
See the manual entry dump{%) in the Commands Reference Manual for the 
Sun Workstation (Part Number: 800-1166) and "Backing-up File Systems" 
with dump in System Administration Manual 

□ If you have the GP and /or GB boards, the following must be done in order 
for them to run. The command letcigpconfig must be run when the worksta¬ 
tion is booted. This command loads the GP and GB boards with their 
respective microcode. This can be done automatically if the file !etc!rc.local 
is edited to include the gpconfig command line. See the manual page for 
gpconfig{Z) in Chapter 7 of this document. 

□ If you have a GP/GB, you must recompile graphics/windows programs to 
use them. 


2.1. What is on the 
Distribution Tape? 


Distribution of the 2.3 Release binaries is either on a 1/4” magnetic tape car¬ 
tridge or a 1/2” nine-track tape. The tapes contain the following files: 

File 1: Boot block. 

A general-purpose boot program which knows how to boot from the 
various devices that can be attached to the Sun Workstation. The 
PROM monitor boots this general-purpose boot program. 


File 2: Bootable diag program. 

diag is the disk formatting and labeling program. 


File 3: Copyright file. 

File 4: tar file of the backup utility and a list of the files it ‘backs-up’. 

This tar file contains two files: the backup utility {2.3_backup) which 
saves the current versions of the files replaced in this upgrade and the 
listing of files which changed between 2.3 and 2.0 {get_arch__f). 
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File 5: tar file of the 2.3 upgrade utility {2.3 jipgrade). 

File 6; tar file of new 2.3 object 

A tar format file of the 2.3 object files, executable files, and libraries. 

File 7: tar file of optional software. 

See Appendix B for a listing of optional software files. 

File 8: Copyright file. 


2.2. Overview of the 

Installation Procedure 



The object of this procedure is to load the Release 2.3 binaries from the magnetic 

tape onto your local or network disk subsystem. You will need to have a blank 

tape for Step 5. 

The basic steps in installation are: 

1 If you are installing a server, halt any diskless clients. 

2. Bring the system down to single user mode. If you are installing a server, 
runjic^:(8) on all the ND partitions. 

3. Load the distribution tape. 

4. Extract the 2.3 backup utility and 2.3 upgrade utility. 

5. Run the 2.3 backup utility. This saves the old versions of files that change in 
2.3. NOTE: If you have already backed up your disk as earlier recom¬ 
mended and you do not t think you will want to uninstall this release, you 
can omit this step. 

6. Run the 2.3 upgrade utility. This installs the new or altered files; if run on a 
server it will update the clients also. 

7. Optionally, use the tar{l) command to extract the optional software (See 
Appendix B for listing of optional software files). 



8. If you have a Sun-2/160 with a Graphics Processor, edit the file tetdrc.local 
to contain a command line fot letclgpconfig{Z). 

9. Reconfigure your system kernel and reboot. 

If you have performed an installation of a Sun system before, you will recall that 

we use several conventions in the procedures and examples to tty and clarify 

things: 

□ What the system types at you is printed in typewriter font like 
this. 

□ What you type at the system is shown in boldface typewriter 
font like this. Everything shown in boldface should be typed 
exactly as it appears. 

□ Where parts of a command are shown in italic text like this, they refer to a 
variable which you have to substitute from a selection; it is up to you to 
make the proper substimtion. 
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10 Release 2.3 Manual/or the Sun Workstation 


The tape variable is important. The values for tape are listed in Table 2-1. 


Table 2-1 Tape Devices 


Devices 

Description 

ar 

Archive quarter-inch tape cartridge 

mt 

Nine-track magnetic half-inch tape 

St 

SCSI tape controller cartridge 

xt 

Xylogics 6250 bpi half-inch tape 


For example, a common configuration would load from a quarter-inch magnetic 
tape cartridge via an SCSI tape controller. In this case, tape would be replaced 
by St (SCSI Tape) everywhere. 

Now, you are ready to begin the actual installation. 


2.3. Single user mode To bring the system down to single user mode, do the following: 

gaia#/etc/shutdown now 


2.4. Load the Distribution 
Tape 

NOTE If you are installing 2.3 on a network disk server, you must have a tape drive on 
the server machine. 

NOTE We do not guarantee full compatibility between the 4-track 20 MByte and the 9- 
track 45 MByte drives. 

Your chances of successfully reading tapes produced by a different type of drive 
are increased if you follow the manufacturer’s instructions for drive mainte¬ 
nance: clean the drive heads after eveiy use of a new tape and after every eight 
hours of use. 

Load the distribution tape. 

The ret option of the mr(l) command will cause the tape drive to wind the tape 
forward to the end and back to the beginning to get even tension on the tape. 


2.5. Extract the 2.3 Backup When you have loaded the tape, use the tar{\) command to extract the 2.3 
and Upgrade Utilities Backup, get_archJ, and 2.3_upgrade utility. 

from Tape ^ if you are using a local tape drive, do the following. Remember to replace 

tape with the appropriate device abbreviadon for your tape (ar for the 
Archive drive, st for an SCSI tape drive, mt for the nine-track tape, or xt for 
the 6250 bpi half-inch tape): 


A sun 

microsystems 


Revision A of 7 March 1986 






Chapter 2 — Installing the 2.3 Release 11 


# cd /usr/etc 

# mt —f /dev/nrrapeO ret 

[Note: a 112" tape cannot be retensioned] 

# mt -£ /dev/nrtfl/jeO rew 

# mt -f /dev/nrtapeO fsf 3 

# tar xvpf /dev/nrtape 0 

X 2.3_bac)cup 3595 Bytes, 8 tape blocks 
X get_arch_f 3479 Bytes, 7 tape blocks 

# mt -f /dev/nrfapeO rew 

# mt -£ /dev/nrra/>e 0 £sf 4 

# tar xvp£ /dev/nrWpeO 

X 2.3_upgrade 4204 Bytes, 9 tape blocks 

# 


□ If you are using a remote tape drive, ^ol'n^ioWo'^ing. Note that, since you 
are performing a remote process as super-user, the hostname of the local 
machine (which you are typing commands on) must be in the remote 
machine’s l.rhosts file to avoid perrriission problems. In addition, each 
machine must have an entry for the other (name and Internet address) in its 
letcihosts file. Remember to replace tape with the appropriate device abbre¬ 
viation for the remote tape drive you are using, to replace remotejiost with 
the hosmame of the machine this tape drive is attached to, and to replace 
block_size with 20b for a 1/2’ ’ tape or 126b for a 1/4” tape: 

# cd /usr/etc 

# rsh remote host mt -£ /dev/nrfapeO ret 

[Note: a 7/2" tape cannot be retensioned] 

# rsh remote host mt -f /dev/nrrapeO rew 

# rsh remote host mt -f /dev/nrWpeO fsf 3 

# rsh remotejiost dd if=/dev/nrtopeO \ 

hs=block_size \ tar xvpBf — 

X 2.3_backup 3595 Bytes, 8 tape blocks 

X get_arch_f 3479 Bytes, 7 tape blocks 

# rsh remoteJost mt —£ /dev/nrtapeO rew 

# rsh remotejiost mt -f /dev/nrta/>eO fs£ 4 

# rsh remotejiost dd i£=/dev/nr/apeO \ 

bs=block_size \ tar xvpBf — 

X 2.3_upgrade. 4204 Bytes, 9 tape blocks 

# 

If you get a‘‘Broken pipe” message, you can ignore it. 

2.6. Run the 2.3 Backup Next, you run the 2.3 backup utility to save the 2.0, 2.1, or 2.2 files on your disk 

Utility that are replaced in this upgrade. This process takes about 20 minutes. 

□ Load the blank tape (make sure it is not write protected). 

The backup utility will not support backup for ND clients. If you have changed 
any of the following files in the clients’ root file systems, you will manually have 
to dump each client. The files affected are: 


A sun 

microsystems 


Revision A of 7 March 1986 



12 Release 2.3 Manual/or the Sun Workstation 


/etc/gplcg2.1024.ucode 

/etc/gplcg2.1152.ucode 

/etc/gpeonfig 

/etc/inetd 

/etc/mount 

/etc/nfsd 

/etc/mount 

/etc/shutdown 

/etc/umount 

/etc/ypbind 

/etc/ypserv 

/etc/yp/makedbm 

/dev/MAKEDEV 


Use vi or ed to create a file called savef ile that contains all of the above 
files. Then you can rar the savef ile to a blank tape by doing the following: 


tar cvf 'cat savefile' 

Whenever you need to"uninstall" a client, "uninstall" your server first then tar 
these files back to client. 


If you are not running the 2.1 release, when you do the 2.3 backup you will see 
the following message: tar: filename: no such file or directory 
for any files that pertain to the 2.1 release. The files affected are: 

/etc/gplcg2.1024.ucode 
/etc/gp lcg2.U52.ucode 
/etc/gpeonfig 

/usr/sys/OBJ/gpl_colormap.o 

/usr/sys/OBJ/gpl_kem_sync.o 

/usr/sys/OB J/gp l_rop.o 

/usr/sys/OBJ/gpone.h 

/usr/sys/OB J/gpone .o 

/usr/sys/conf/SDST160GP 

/usr/sys/sun/ gpio .h 

/usr/include/sun/gpio.h 

/u sr/i nclude/gp 1 jpwpr.h 

/usr/lib/lint/Ilib-lcqi.ln 

/usr/lib/lint/llib-lcgi 


□ Load the blank tape (make sure it is not write protected). 

If you are not using the yellow pages and have moved ypbind to ypbind-, you 
will want to reverse this so \h 2 Lt ypbind is backed up. Do the following command 
before you proceed: 


#mv /etc/ypbind- /etc/ypbind 
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There are two parameters to the 2.3_backup utility, (the command is printed on 
two lines for formatting purposes only; type it as a single line); 

# /usr/etc/2.3_backup {arImt1st1xt} 

{server | tapefull 1 tapeless server_name ) 

The backup command and system response for a server machine will look like 
this: 

# /usr/etc/2.3_backup itit server 
Beginning backup 

backup: load blank tape to mt press <return> please. 
Extracting object files for backup. 

□ Unload the blank tape (now containing 2.+ files) and make sure it is write 
■ protected! 


2.7. Run the 2.3 Upgrade Load the release tape now. 
Utility 


NOTE Do not run SunWindows during the upgrade procedure. 

If you are doing the upgrade on a server, note that the upgrade utility takes care 
of 2.3 upgrade on your diskless clients, but that it assumes a standard form of the 
nd configuration file /etcind.local in order to do so. In particular, if there are 
lines in the server'i Ietclnd.local for client partitions which are commented out 
(lines with a leading ‘#’), these clients will not have 2.3 installed on them. If you 
wish to have the 2.3 Release installed on these clients, you must remove the com¬ 
ment symbol from their lines in the file before performing installation on the 
server. If you do not do this during the initial install, you will have to run 
through the entire installation procedure again (on the server and all the clients) 
in order to bring the commented-out client partitions up to date. 

Also, if your/ercW./<?C( 2 /file has user... lines and/or ether ...lines 
that refer to non-existent clients, comment out these lines before mnning the 
installation utility. Again, the utility will not run to completion if this is not 
done. 

There are two parameters with the 2.3jupgrade utility, (the command is printed 
on two lines for formatting purposes only; type it as a single line): 

# /usr/6tc/2 .3_upgrade {arI rat 1st) 

{server t tapefull | tapeless serverjiarne ) 

□ The first set specifies your tape device: 
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Table 2-2 Tape Devices 


Devices 

Description 

ar 

Archive quarter-inch tape cartridge 

mt 

Nine-track magnetic half-inch tape 

st 

SCSI tape controller cartridge 

xt 

6250 bpi half-inch tape 


□ The last designates your machine as a server, standalone with tape drive, or 
workstation without a tape drive using a another machine’s {serverjiame) 
tape drive: 

server 

tapefull 

t a pe le s s server_name 

For example, the installation command and system response for a server machine 
with a half-inch tape drive would look like this: 

# /■usr/etc/2.3_upgrade mt server 
Beginning 2.3 install. 

Extracting 2.3 object files. 

[ and soon ... extraction takes about 20 minutes ... ] 

Installing new bootable code on server. 

Beginning 2.3 install on diskless clients. 

Beginning 2.3 install on client client_1. 

Completed 2.3 install on client client_1. 

Beginning 2.3 install on client client_2. 

Completed 2.3 install on client client^. 

Beginning 2.3 install on client client_3. 

Completed 2.3 install on client client_3. 

Completed 2.3 install on diskless clients. 

Running ranlib on new libraries. 


2.3 install completed. 

You should now reconfigure and rebuild your kernel. 

NOTE If you are using an SCSI tape for the install, you may get a message like 

“/dev/nrstO rewind 1 failed; I/O error” at the beginning or 
end of the install utility. You can ignore it. 
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To install the release on a tapeless workstation using the 1/4” SCSI tape drive on 
a machine named hal, the command line would be; 

# /usr/etc/2.3_upgrade st tapeless hal 


The seventh file on the upgrade tape contains new/revised manual pages, several 
new color demos and games, and GP diagnostics, SunWi-ndows, Suntools, CGI, 
Fortran, etc. See Appendix B for a complete list of optional software and file 
sizes. You may optionally load this software. To extract the optional software 
use the directions that follow, 

□ First forward position the tape with mt{\) to file 7. 

# cd / 

# mt —f /dev/nrt< 2 pe 0 rew 

# mt —f /dev/nr/ape0 fsf 6 

NOTE Use the appropriate command line arguments to tar to select which directories 
you wish load. See Appendix B for the appropriate command line If you do not 
specify a directory, tar loads all the optional software. The complete load takes 
about 14 minutes, regardless of which options are chosen. 

NOTE Any file with .a after it, MUST have ranlib run on it in order to properly 

update the libraries. 

For a machine with a local tape drive; 


2,8. Loading Optional 
Software from the 
Release Tape 
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# tar xvpf /dev/nr/apeO 

loads all optional software 

# tar xvpf /dev/nrrape0 ./usr/man 

loads manual pages 

# tar xvpf /dev/nrwpeO ./usr/demo 

loads demonstration programs 

# tar xvpf /dev/nrfapeO ./usr/gaities 

loads games 

# tar xvpf /dev/nr/apeO Fortran files 

loads Fortran 

# tar xvpf /dev/nrMpe 0 SunWindows and suntools 

loads Sunwindow and suntools executables and libraries 

# tar xvpf /d.&'v/nTtapeO SunCore and CGI libraries 

loads SunCore and CGI libraries 

# tar xvpf /dev/nrfa/jfi 0 Profiled libraries 

loads Profiled libraries 

# raiilihfilename 

updates the libraries 

# tar xvpf /dev/nr/npeO SunWindows tool & demo program source 

loads SunWindows tool source and demoslration program source 

# tar xvpf /dev/nrrapeO Versatec Printer software 

loads Versatec Printer software 

# tar xvpf /dev/nrrape 0 diagnostic programs 

loads diagnostic programs 

# tar xvpf /dev/nrfapeO ./stand/diag 

loads the standalone diagnostics 

# mt -f /dev/nr/apeO rew 

For a machine using a remote tape drive, type the following. Remember to 
replace tape with the appropriate device abbreviation for the remote tape 
drive you are using, to replace remote_host with the hostname of the 
machine this tape drive is attached to, and to replace block_size with 20b for 
a 1/2” tape or 126b fora 1/4” tape: 

# cd /usr 

# rsh remoteJiost mt -f /dev/nxtapeO rew 

# rsh remote Jiost mt -f /dev/nrrapeO fsf 6 

# rsh remote Jiost dd if=/dev/nr/<3pe0 \ 

hs=block_size 1 tar xvpBf - ./usr/man 

# rsh remoteJost mt -£ /dev/nrtapeO rew 

See the above discussion of loading with a local tape drive for an explana¬ 
tion of how to optionally load the manual pages, demonstration programs 
and/or games with tar. 

The dd command above wiU print the number of records read in and written out, 
for example: 

6+0 records in 
6+0 records out 

This message may be interspersed with the standard error output from tar and, in 
any case, may be ignored. Also, you can ignore the “Broken pipe” message 
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delivered by tar. 

NOTE If you load the pages, and normally use catman(8) to create pre-formatted copies 

of your online manual pages, then don’t forget to re-issue the catman command 
for the new 2.3 pages. 


2.9. Reconfigure your Finally, to complete the 2.3 Release installation, you must reconfigure your sys- 

UNIX System Kernel tern kernel. Your new kernel will contain the 2.3 kernel object file fixes. Note 

that changes have been made to the device description lines in the kernel 
configuration file to allow for the Sun-2/160 GP option. 

NOTE Changes have been made to the device description lines in the kernel 
configuration file to allow for the Sun-21160 GP option. 

If you are doing kernel configuration for the first time, you can use the pro¬ 
cedures in 

Installing UNIX on the Sun Workstation 
(Part Number; 800-1158). 

If you have previously configured a kernel, you can use the following sections to 
guide you through reconfiguration. The first subsection gives reconfiguration 
procedures for standalone machines, the second subsection addresses servers, and 
the third subsection is an annotated copy of the new GENERIC kernel 
configuration file; read it carefully to make sure you are insluding the correct 
device description lines for your system. 


NOTE If you are not using a Sun2ll60 workstation, you can skip any steps that pertain 

to the GP or GB in the next sections. 


Kernel Reconfiguration for 
Standalone Systems 


For standalone machines, proceed as follows. 
1. Change the current directory to fsys/conf: 
# cd /sys/conf 


2. Create a kernel configuration file. There are two ways to produce the kernel 
configuration file. 

n Copy the file GENERIC and comment out the lines that don’t apply to your 
system. We’ll call the new file SYSJIAME (the name of the system). For 
example, 

# cp GENERIC SYSJtAME 

# chmod +w SYSJIAME 

□ Alternatively, copy the kernel configuration file that most closely matches 
your system. There is a new kernel conficuration file for the Sun-2/160s 
with the GP/GB, SDSTI60GP. Copy this onto a file called SYSJIAME (the 
name of the system). This file is a basic Model 160 kernel configuration file. 


Asun 

XT micfosystems 


Revision A of 7 March 1986 




18 Release 2.3 Manual for the Sun Workstation 


If you have any additional devices on your system, you should add lines to 
this file as appropriate for your system. 

# cp SDST160GP SYS_NAME 

# chmod +w SYS_NAME 

3. Edit lsyslconflSYS_NAME to reflect your system configuration. Use the anno¬ 
tated copy of GENERIC provided in the following section for an explanation 
of these changes. Make sure you are including the proper device description 
lines for your system. 

4. Edit the file letcirc.local to'hontain a line for the gpconfig{S) command. 

/etc/gpconfig gponeO -b -f cgtwoO 
(for initializing the GP and GB) 


/etc/gpconfig gponeO -f cgtwoO 
(for initializing the GP only) 

If you don’t want to have the GP and/or GB boards active all die time, you can 

run the gpconfig{%) command interactively. 

5. Create the directory .JSYS_NAME (if you haven’t already) to contain the ker¬ 
nel image. Remember: since the system build utility (etdconfig places its 
output files there, this directory must have the same name as your system 
configuration file: 

# mkdir . . /SYS_NAME 

6. Still in the /sys/conf directory, run /etdconfig. Then change directory to the 
new configuration directory, and make the new system (remember to substi¬ 
tute your actual system image name for SYS JIAME): 

# /etc/con£ig SYSJiAME 

# cd . . /SYSJfAME 

# make depend 

[ lots of output ] 

# make 

[ lots of output ] 

7. Now you can save your old kernel and install your new one: 
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# itiv /vmuiiix /vmunix.old 

# cp vmunix /vmunix 

# /etc/shutdown -h now 

The system goes through the halt sequence, then 
the monitor displays its prompt, at which point you 
can boot the system: 

> b 

The system boots up multi-user, and then 
you can try things out. 
gaia# 

8. If the system appears to work, this completes the upgrade procedure. If per¬ 
formance is slow, check that gpconfig has been run properly. If the new ker¬ 
nel doesn’t seem to be functioning properly, hoox^Nmunix.old, copy it back 
to Ivmunix , and go about fixing your new kernel; 

# /etc/shutdown -h now 

> b vmunix.old -s 

# mv /vmunix /vmunix.oops 

# cp /vmunix.old /vmunix 

# 'D [ Brings the system up multi-user ] 
gaia# 



Kernel Reconfiguration for 
Servers 



For server machines, proceed as follows. 

1. Change the current directory to /sysiconf: 

# cd /sys/conf 

2. Create a kernel configuration file. There are two ways to produce the kernel 
configuration file. 

a Copy the file GENERIC and comment out the lines that don’t apply to your 
system. We’ll call the new file SYS_NAMB (the name of the system). For 
example, 

# cp GENERIC SYSJtAME 

# chmod +w SYS_NAMB 

□ Alternatively, copy the file SDST160GP onto a file called 5y3’_A/AW£ (the 
name of the system). This file is a basic Model 160 kernel configuration file. 
If you have any additional devices on your system, you should add lines to 
this file as appropriate for your system. 

# cp SDST160GP SYSJtAME 

# chmod +w SYSJ/AME 

3. Edit lsys/conJ)SYS_NAME to reflect your system configuration. Use the anno¬ 
tated copy of GENERIC provided in the previous section for an explanation 
of these changes. Make sure you are including the proper device description 
lines for your system. 
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4. Edit the file !etc!rc.local to contain a line for the gpconfig{%) command. 

/etc/gpconfig gponeO -b -f cgtwoO 
(for initializing the GP and GB) 


/etc/gpconfig gponeO -f cgtwoO 
(for initializing the GP only) 

If you don’t want to have the GP and/or GB boards active all the time, you can 
run the gpconfig(%) command interactively. 

5. Create the directory .:SYS_NAME (if you haven’t already) to contain the kernel 
image. Remember: since the system build utility /etc/config places its out¬ 
put files there, this directory must have the same name as your system 
configuration file: 

# mkdir . . /SYSJiAME . 

6. Still in the Isysiconf directory, run letciconfig. Then change directory to the 
new configuration directory, and make the new system (remember to substi¬ 
tute your actual system image name for SYS_NAME): 

# /etc/con£ig SYS_NAME 

# ed . . /SYSJiAME 

# make depend 

[ lots of output ] 

# make 

[ lots of output ] 

7. If you have a specially configured client kernel, it can be reconfigured now 
as well: 

# cd /sys/conf 

# cp GENERIC CUENT_KERNEL_NAME 

# chmod +w CUENT_KERNEL_NAME 

[ Edit CLIENT_KERNEL NAME to reflect all clients’ systems. 

Be especially careful with the device description lines, given above. ] 

# mkdir , . /CUENT_KERNEL_NAME 

# /etc/config CUENT_KERNEL_NAME 

# cd . . /CUENT_KERNEL_NAME 

# make depend 

[ lots of output ] 

# make 

[ lots of output ] 

8. Now you can position yourself in the directory which has the server’s kernel 
in it, save your server’s old kernel, install your new one, and try everything 
out: 
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# cd . . /SYSJIAME 

# mv /vmunix /vmunix.old 

# cp vmunix /vmunix 

# /etc/shutdown -h now 

The system goes through the halt sequence, then 
the monitor displays its prompt, at which point you 
can boot the system: 

> b 

The system boots up multi-user, and 
then you can try things out. 
gaia# 

9. Next, install the appropriate client kernel in fpub. 

o If you reconfigured a special client kernel (in Step 5 above), copy it into 
/pub: 

.# cd /sys/CUENT_KERNELJIAME 

[or wherever your client kernel jj] 

# cp vmunix /pub/vmunix 

□ Otherwise place a copy of your server’s kernel (if appropriate) in Ipub: 

# cp /vmunix /pub/vmunix 

10. If everything appears to work, you can finish by rebooting each of your 
clients. See the final step in the standalone instructions above if you have 
problems with your kernel. 

NOTE If you want to run the yellow pages, be sure to move ypbind- back to 
Ypbind. 

If performance is slow, check that gpconfig has been run properly. 

Kernel Reconfiguration — an The following pages provide an annotated copy of the GENERIC file shipped 
Annotated Copy of GENERIC with this distribution. You can use the explanations of each line in the file to 

determine which lines should be included in your own system configuration file, 

# 

# GENERIC SUN 

* 

machine sun 

[mandatory,] 

cpu "SUN2" 

[mandatory,] 


ident GENERIC 

[mandatory. If you use GENERIC as your system identifier, you may use the swap generic clause in the 
conf ig line below. If you customize the identifier to SYSJIAME, you must either include an options 
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GENERIC line, or specify at least the device where your root file system lives in place of swap generic. For 
example, the config line for a Standard Sun-2 might read: config vmunix root on xy. Set General 
and Specific System Description Lines, in Installing Unix on the SunWorkstation above, for information. Finally, 
if SYS_NAME contains both alpha and numeric characters (as in, for example, SDST120), you must enclose the 
name in double quotes ("SDST120") or you will get a syntax error when you run /etc/config.] 

timezone 8 dst 

[mandatory. Specifies your timezone. Adjust value accordingly.] 

maxusers 4 

[mandatory. Number may vary. For most systems, “2” is the proper value for maxusers. 
options INET 

[mandatory. Controls inclusion of Internet code. See mef(4). You must also include the pseudo-device 
inet and pseudo-device loop lines below.] 


options SYSACCT 


[Controls inclusion of code to do process accounting. See acct(2) and acct(5). 
also include the pseudo-device sysacct line below.] 

options RPC 


If you include this line, you must 

o 


[Necessary for the network file system.] 


options NFS 

[Necessary for the network file system.] 


config vmunix swap generic 

[mandatory. Specify kernel name and configuration clauses. See Specific System Description Lines, above, for 
information.] 

pseudo-device rpc 

[Necessary for the network file system.] 


pseudo-device nfs 

[Necessary for the network file system.] 

pseudo-device pty 

[Pseudo-tty’s. Needed for network or window system.] 
pseudo-device bk 
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[Berknet line discipline for high speed tty input. See M(4).] 

pseudo-device sysacct 

[See options SYSACCT line above.] 

pseudo-device inet 

[mandatory. See options INET line above.] 

pseudo-device ether 

[mandatory. 

ARP code. See arp{A).] 

pseudo-device loop 

[mandatory. Software loop back network device driver. See/o(4). Must include with‘options INET’.] 

pseudo-device nd 

[Network disk. Necessary for servers and diskless clients, and for machines serving as remote hosts for remote 
installation. See nd{A).] 

pseudo-device win128 

[Window system. Number indicates maximum windows. If you include this line, you must also include the 
pseudo-device dtop, ms, and kb lines just below.] 


pseudo-device dtop4 

[Maximum number of screens (desktops). Required for window system.] 

pseudo-device ms3 

[Maximum number of mice. Required for window system. See m5(4).] 


pseudo-device kb3 

[Maximum number of Sun keyboards. Required if using any Sun keyboard, and for the window system.] 


pseudo-device Ingres 

[Sun MicroINGRES lock device.] 

controller mbO at nexus ? 

[mandatory. Main bus code.] 


controller ipcO at mbO csr all virt 0xeb0040 priority 2 

♦ 
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[1st Interphase SMD disk controller. See ip{4).] 

controller ipcl at robO csr all virt 0xeb0044 priority 2 

[2nd Interphase controller.] 

disk ipO at ipcO drive 0 

[1st disk on 1st Interphase controller.] 

disk ipl at ipcO drive 1 

[2nd disk on 1st Interphase controller.] 

disk ip2 at ipcl drive 0 

[1st disk on 2nd Interphase controller.] 

disk ip3 at ipcl drive 1 

[2nd disk on 2nd Interphase controller.] 

controller xycO at mbO csr all virt 0xebee40 priority 2 vector xyintr 72 

[1st Xylogics SMD disk controller. See ;<:>'(4).] 

controller xyol at mbO csr all virt 0xebee48 priority 2 vector xyintr 73 
[2nd Xylogics controller.] 

disk xyO at xycO drive 0 

[1st disk on 1st Xylogics controller.] 
disk xyl at xycO drive 1 

[2nd disk on 1st Xylogics controller.] 

disk xy2 at xycl drive 0 

[1st disk on 2nd Xylogics controller.] 

disk xy3 at xycl drive 1 

[2nd disk on 2nd Xylogics controller.] 

controller scO at mbO csr 0x80000 priority 2 

[1st SCSI controller on a Sun-2/120 or Sun-2/170.] 
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o 
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controller scO at mbO csr vme busmem 0x200000 priority 2 vector scintr 64 

[1st SCSI controller on a Sun-2/160.] 

disk sdO at scO drive 0 flags 0 

[1st disk on 1st SCSI controller.] 

disk sdl at scO drive 1 flags 0 

[2nd disk on 1st SCSI controller.] 

tape stO at scO drive 32 flags 1 

[1st SCSI tape.] 

controller scl at mbO csr 0x84000 priority 2 

[2nd SCSI controller.] 

disk sd2 at scl drive 0 flags 0 

[1st disk on 2nd SCSI controller.] 

disk sd3 at scl drive 1 flags 0 

[2nd disk on 2nd SCSI controller.] 

tape stl at scl drive 32 flags 1 

[2nd SCSI tape.] 

device ropcO at mbO csr OxeeOSOO 

[mandatory. RasterOp chip. See ropc{A).] 

device skyO at mbO csr 0x2000 priority 2 

[Sky Floating Point board in any Sun-1, Sun-2/120, or Sun-2/170.] 

device skyO at mbO csr vme busio 0x8000 priority 2 vector skyintr 176 

[Sky Floating Point board in a Sun-2/50 or Sun-2/160.] 

device zsO at mbO csr all virt OxeecSOO flags 3 priority 3 # cpu 

[CPU serial I/O ports. See z5(4).] 

device zsl at mbO csr all virt OxeecOOO flags 0x103 priority 3 # video 
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[Sun-2 Video Board ports. Required for Sun-2 keyboard and mouse.] 

device zs2 at mbO csr 0x80800 flags 3 priority 3 

[1st two serial I/O ports on 1st SCSI Board.] 

device zs3 at inbO csr 0x81000 flags 3 priority 3 

[2nd two serial I/O ports on 1st SCSI Board.] 

device zs4 at mbO csr 0x84800 flags 3 priority 3 

[1st two serial I/O ports on 2nd SCSI Board.] 

device zs5 at tnbO csr 0x85000 flags 3 priority 3 

[2nd two serial I/O ports on 2nd SCSI Board.] 

device mtiO at mbO csr all virt 0xeb0620 flags Oxffff priority 4 vector mtiintr 136 

[Systech terminal MUX. See mrt’(4).] 

device ieO at mbO csr 0x88000 priority 3 

[1st Sun-2 Ethernet Controller on a Sun-2/120 or Sun-2/170.] 

device ieO at mbO csr vme virt 0x0ee3000 priority 3 

[1st Sun-2 Ethernet Controller on a Sun-2/50 or Sun-2/160.] 

device iel at mbO csr OxScOOO flags 2 priority 3 

[2nd Sun-2 Ethernet Controller on a Sun-2/120 or Sun-2/170.] 

device ecO at mbO csr OxeOOQO priority 3 

[1st 3COM Ethernet Controller. See ec(4).] 

device iel at mbO csr vme busmem 0xe88000 priority 3 
device eel at mbO csr 0xe2000 priority 3 

[2nd 3COM Ethernet Controller. See ec(4).] 

controller tmO at mbO csr all virt OxebOOaO priority 3 vector tmintr 96 

[1st TAPEMASTER tape controller. See tmiA).] 

controller tml at mbO csr all virt 0xeb00a2 priority 3 vector tmintr 97 

[2nd TAPEMASTER tape controller. See tm{A).] 
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tape mtO at tmO drive 0 flags 1 

[1st 1/2” tape drive on IstTAPEMASTER controller.] 

tape mtl at tml drive 0 flags 1 

[1st 1/2” tape drive on 2nd TAPEMASTER controller.] 

controller xtcO at itibO csr all virt OxebeeSO priority 3 vector xtintr 100 

controller xtol at mbO csr all virt 0xebee68 priority 3 vector xtintr 101 

tape xtO at xtcO drive 0 flags 1 

tape xtl at xtcl drive 0 flags 2 

device arO at tnbO csr 0x200 priority 3 

[1st 1/4” tape drive. See ar(4).] 

device arl at mbO csr 0x208 priority 3 

[2nd 1/4” tape drive.] 

device gponeO at mbO csr vme busmem 0x210000 priority 3 

[Sun Graphics Processor board.] 

device cgtwoO at mbO csr vme busmem 0x400000 priority 3 

[Sun-2 color graphics interface. Required if gpone config line is present. See cgfwcj(4s).] 

device cgoneO at mbO csr OxecOOO priority 3 
device cgoneO at mbO csr vme busmem OxlecOO priority 3 

[Sun-1 Color Board. See cgo«e(4s).] 

device bwtwoO at mbO csr 0x700000 priority 4 

[1st monochrome monitor on a Sun-2/120 or Sun-2/170. See £>wnvo(4s).] 

device bwtwoO at mbO csr vme obio 0x0 priority 4 

[1st monochrome monitor on a Sun-2/50 or Sun-2/160.] 

device bwoneO at mbO csr OxcOOOO priority 3 

[1st monochrome Sun-1 monitor. See bwone{As).'\ 

device vpO at mbO csr 0x400 priority 2 

[Ikon Versatec Board. See yp(4).] 

device vpcO at mbO csr 0x480 priority 2 
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[1st Systech Centronics/Versatec Board. See ypc(4s).] 
device vpcl at «ibO csr 0x500 priority 2 

[2nd Systech Centronics/Versatec Board.] 



device piO at mbO csr 0xee2000 

[Parallel input. Only used on Sun Models lOOU and 150U, for keyboard and mouse.] 

device desO at mbO csr all virt OxeelSOO 

[Interface to the AMD8068 Data Ciphering Processor, a hardware implementation of the NBS Data Encryption 
Standard.] 

device todO at mbO csr OxeelOOO 

[Time of day clock on the Sun-2/120 or Sun-2/170.] 

device todO at mbO csr vme busmem 0x200800 

[Time of day clock on the Sun-2/160 or Sun-2/50.] 


o 
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2.10. Uninstalling the 2.3 
Release 


NOTE 


If you run into problems while running 2.3, you can back out the changes by 
using the tape which you got after running 2.3_backup. You then reconfigure 
your kernel, and can run as you were before. Proceed as follows. 

Optional software is not backed out during the uninstall. 


NOTE If you are ‘uninstalling’ a network disk server, you must halt all diskless clients 

before proceeding. 

1. Load the backup tape, you made as part of the installation procedure. 

2. If you have edited letcirc.local to contain a line for the gpconfig{%) com¬ 
mand, that file should be re-edited to remove or comment out the line. 

gaia# /etc/shutdown now 
gaia#mt -f /dev/nrfapeO rew 
# tar xvpf /dev/nrfapeO 

This takes about 15 minutes. 

4. Reconfigure your kernel. See Section 2.11. 

5. If an ND server, manually reload files onto ND client partitions. 
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New Graphics Processor and Graphics 
Buffer Options for the Sun-2/160 

This chapter describes the contents of the Release 2.1 which exclusively sup-^ 
ported the Sun-2/160 Color Workstation with the new Graphics Processor and 
Graphics Buffer options. Since these options are VME bus compatible boards 
that require a color system, Release 2,1 was restricted to the Sun-2/160. IF YOU 
DO NOT HAVE Sun-2/160 Color Workstation with the new Graphics Processor 
and Graphics Buffer PROCEED TO CHAPTER 3. 

The procedures for installing and testing this special release are incorporated in 
Release 2.3. A Release 2.0 installation is required before a Release 2.3 upgrade. 

The Graphics Processor (GP) and Graphics Buffer (GB) boards are options 
designed to enhance graphics performance for the Sun-2/160 Color Workstation. 
These are Eurocard format printed circuit boards that fit into VME slots of the 
Sun-2/160 card cage. 

There are no new software products in Release 2.1. 

The operating system software changes include a device driver for the Graphics 
Processor, microcode that is downloaded into the Graphics Processor, and a 
configuration utility that binds frame buffers to a GP board. 

The lowest level command interface for the Graphics Processor is not included. 
The Graphics Processor can only be used through the graphics library routines 
that have been expanded to communicate with the GP. 

Device Drivers The file gpone.o is a binary copy of the device driver for the Graphics Processor 

board. It is installed in tl-e kernel configuration directory during the software 
installation procedure. 

The file cgtwo.o is a new binary copy of a device driver for the color frame 
buffer. It has additional wct/’s for communicating with the Graphics Processor. 
This device driver is upward compatible with previous versions. 

The file consfb.o is a new binary copy of the device driver for the console frame 
buffer. Some applications like sunroo/j(l) use Idevifb as the default frame 
buffer. This new version allows redirection of the GP frame buffer driver to 
Idevifb. 



3.1. New Hardware 
Products 


3.2. New Software 
Products 

3.3. Changes to Operating 
System Software 
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Downloadable GP Microcode The files Ietclgplcg2.1152.ucode and /etc!gplcg2.1024.ucode contain microcode 

that is downloaded into the Graphics Processor board when the Sun-2/160 is 
booted. 

gpconfig Command The gpconfig command binds specific frame buffers to the Graphics Processor 

board. Since an individual Graphics Processor board can drive up to four frarne 
buffers, the GP driver must be given certain frame buffer specific information. 
Chapter 4 includes a manual page, gpconfig{^), that describes the gpconfig com¬ 
mand and its arguments. If the Graphics Processor is to be used regularly, the 
gpconfig command should be added to the file !etc!rc.local. 


3.4. Changes to Application The application software that changed is limited to the graphics libraries listed 
Software below. New versions of some of the utilities from Release 2.0 must be recom¬ 

piled to mn with these new libraries, but we do not provide 2.0 utility source. 

Graphics Libraries Four libraries in lusrilib have been revised to use the Graphics Processor board. 

Any application programs that depend on these libraries should be relinked with 
the newer versions. 

SunCGI The Sun Microsystems implementation of the Computer Graphics 

Interface (CGI) standard reflects Sun Microsystems interpretation of 
the March 1984 working draft of CGI. The file libcgi.a is a new ver¬ 
sion of this graphics library for use with the GP. See Programmer’s 
Reference Manual for SunCGI (Part Number: 800-1166). Section 4 
has an errata page reflecting the new GP device that should be 
included in this manual. 

SunCore SunCore is an implementation of the ACM Core graphics standard 
with extensions. The file libcore.a is a new version of this graphics 
library for use with the GP. The file libcoresky.a is a version of this 
library for use with the GP and a SKY floating point board. See 
Programmer’s Reference Manual for SunCore (Part Number: 800- 
1165). Section 4 has an errata page reflecting the new GP device 
that should be included in this manual. 

Pixrects Pixrects is a low-level graphics libraty for manipulating rectangles 
of pixels with RasterOps. The file libpixrect.a is a version of this 
graphics library for use with the GP. See Programmer’s Reference 
Manual for SunWindows — the Sun Window System (Part Number; 
800-1167) and Programmer’s Tutorial to SunWindows (Part 
Number: 800-1182). 


SunWindow Tools There are no new SunWindow tools with this release. Tools from Release 2,0 

must be reinstalled with the new graphics libraries described above. This is per¬ 
formed automatically installation utility. 

NOTE Locally written tools must be relinked with the new graphics libraries. 
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This release represent the first stage of an ongoing effort to improve graphics per¬ 
formance through the use of the GP. The Pixrects, SunCGI, and SunCore graph¬ 
ics libraries will all provide increased performance. The sections that follow out¬ 
line the graphics performance improvements resulting from the GP. 

Vector pixel rates have increased by about a factor of 5. Solid-filled rectangle 
rates have increased by more than a factor of 3. RasterOps from one area to 
another on the frame buffer (e.g. scrolling) have increased by more than a factor 
of 3. Polygon scan conversion is nearly 10 times faster for certain polygons Pix¬ 
rects cannot currently exploit the full performance of the GP due to the lack of a 
batching mechanism. 

Sun CGI takes advantage of the Pixrects level performance improvements and 
also used the GP to perform coordinate transformations from VDC to device 
coordinates. SunCGI also sends the vectors of a polyline to the GP as a batch of 
vectors which greatly improves polyline speed. 

Since SunCore has floating point world coordinates and a display list, several 
further performance improvements are achieved with the GP. Vectors can be 
read out of a retained segment in the display list, 3D images transformed, clipped 
and drawn at over 20,000 vectors per second. The transformations from floating 
point world coordinates to NDC space are performed by the GP as well as vari¬ 
ous matrix multiply operations. These floating point operations are improved by 
as much as 200 times. 2D and 3D solid color or Gouraud shaded polygons are 
transformed, clipped, scaled, or rendered by the GP. If a GB board is present, 
hidden surface elimination for 3D solid or Gouraud shaded polygons is also per¬ 
formed by the GP. 
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Changes from the 2.1 Release Software 


This chapter briefly presents the bugs which are fixed in Release 2.2. The bugs 
are sorted under general headings: Compiler, Graphics, Kernel, Network, Utili¬ 
ties, Windows, Documentation, and Miscellaneous. As noted in the “Introduc¬ 
tion”, Release 2.2 is primarily concerned with general system bug fixes. To take 
advantage of the bug fixes in the libraries, programs should be recompiled. 

4,1. Language Processors 

Assembler The assembler has been corrected to accept compiler lines in the 

symbolname =. form. 

C Compiler The C compiler now compiles the assignments of address register variables to the 

bit fields correctly. 

Compiler expressions in the form <expr>%l == 0 no longer generate an 
illegal instruction tstl #0. 

The C compiler no longer produces a fatal error message when compiling a struc- 
mre declaration with too many initial values. 

In Release 2.0, array subscript fragments could make the C compiler loop and the 
message compiler error; expression causes compiler 
loop; try simplifying would appear. This has been fixed. 

FORTRAN FORTRAN DO-loops with floating point index variables have been corrected. 

Previously, these caused compile time errors when the -f sky option was used. 

FORTRAN arithmetic expressions containing array references now compile 
correctly when using the -f sky option. Previously, these compiled incorrectly 
resulting in a segmentation fault at run time. 

The f 77 compiler generates large offsets in base displacement addressing of 
common blocks resulting in assembly time errors. This bug has been fixed. 

The bad read of list-directed floats has been fixed, list directories that read 
statements with floating point arguments use to produce incorrect results, 

A memory allocation error in the Fortran optomizer has been fixed. 
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4.2. Graphics 
CGI 


Pixrects 

Graphics Processor 


A syntax error in DATA statement that the compiler uses caused an abort. This 
has now been fixed. 

The -Nx option must come before the file name(s), otherwise the flag is used by 
the loader. This is not a bug in f 7 7 but rather a clarification. 


If a viewport is made smaller than a clip rectangle and then enlarged, the smaller 
viewport is also enlarged. Previously, when a viewpon was made smaller than a 
clip rectangle, then made larger, the smaller viewport remained. 

circular_arc . 3pt returns an error message when given collinear or coin¬ 
cident points. Previously, there was no error message when this occurred. 

When five view surfaces are opened, and then one is closed, the others stay open. 
In Release 2.0, the other view surfaces could not be reopened. 

The CGI package did not free up the memory which it had allocated once it was 
done with it, now it does. 

Now when the expression within the function inquire_text_extent is set 
to the value string (which indicates raster text), the function no longer returns 
a message indicating that there is no text. Previously, the function returned a 
message indicating that there was no text in this file when in fact text did exist. 

Bundled attributes now automatically rescale. They did not in the 2.0 release. 

pr rop is now working for l-bit and n-bit memory pixrects. The bug used to 
trash the text on a retained pixwin (on a Sun-2/160 color window) when the win¬ 
dow redisplayed. 

In order to gain full screen access, a program running in a window called 
fullscreen_init calls to pw_replrop. This program will now expand 
to full screen access. Previously, it would clip to the foundries of the original 
pixwin. 

Circular arcs of width one now display on the Graphics Processor. 

The Graphics Processor no longer hangs if the number of polygon vertices is 
higher than 25. 

The hidden surface removal now works using the Graphics Processor without the 
Graphics Buffer. Previously, there appeared to be a hardware buffer even when 
it was not present. 

A Graphics Processor device driver declaration has been added to 
/usr/include/pascal/devincpas.h. 

3-D polygons in temporary segments drawn on a gpl view surface are now 
shaded correctly. Previously, due to a bug in /usr/lih/libcore .a, the 
view surface would sometimes shade unevenly. 
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4.3. Kernel 

Driver 


NFS 


Miscellaneous 
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A terminal on /dev/ttya that is being used as a console will no longer hang 
after the telnet(2) gives the login message. 

The old and new tty line disciplines now control the tty line flow in raw 
mode, cbreak mode, and cooked mode. In Release 2.0, old and new tty 
line disciplines would control the tty line flow only in raw mode or 
cbreak mode, not in cooked mode. 

Sun machines with Sun Ethernet boards not plugged into a network generated 
ieO : ethernet jammed messages every ninety seconds if ifconfig(%) had 
been run. Running ifconfig ieO down will now solve the problem. 

KIOCSETKEY ioct 1 no longer interacts with the keyboard translation tables 
in such a manner that random locations in the kernel are trashed if the user 
changes the interpretation of keys. 

Heavily loaded servers sometimes locked up with processes hung waiting for 
disk I/O on a Xylogics controller. This was a hardware problem with the Xylo- 
gics 450 disk controller. The driver was modified to compensate for it. 

NFS client programs no longer cause the NFS server to panic with an address 
error when attempting a negative seek. The code has been modified to check for 
negative file offsets. 

A bad block in a directory caused a server to panic when using the system call 
readdir. This bug has been fixed. 


When trying to run very large programs with very large text sizes and small data 
sizes, the system used to crash. Now, the process fails to execute. 

The bogus trace/BPT trap has been corrected. Previously, processes were 
intermittently dying during forks. 

The kernel configuration file /usr/sys/conf/ND120 hasbeencorrected.lt 
had an entry for the pseudo-device dtop which was incorrect. 

A line for iel for VME-based systems has been added to the generic kernel 
making it possible to use the generic kernel on a VME-based gateway machine. 

The kernel now detects bad addresses between the text and date segments sent by 
user’s programs Previously, the kernel did not check the PTEs carefully and the 
system would panic, monop(l) is one program that generates these bad 
addresses. 

A line has been added to the GENERIC configuration file so a medium resolution 
color monitor will work with a Sun-2/160 or Sun-2/130. 

The Systech mux board driver has been fixed. A bug in the driver caused the sys¬ 
tem to crash under certain error conditions, most often occurring on heavily 
loaded systems. 
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The system no longer panics when it allocates a new inode in a cylinder group 
that is very full. 


4.4. Network 

Protocol 


Yellow Pages 


Miscellaneous 


4.5. Utilities 


Miscellaneous 


The bug in UDP RPC programs that call to recvfrom after a fork has been 
fixed. 

TCP RPC programs no longer hang if the server crashs during a remote pro¬ 
cedure call. 

Gateway system’s TCP code decremented an internet packet time-to-live counter 
by too much, limiting the maximum number of hops of a TCP packet to four. 
This has been fixed. 

Erroneous comparisons of usernames in the password file has been corrected. In 
Release 2.0, it caused yppasswd to think that names which were only similar 
were in fact the same. 

There was a memory leak in ypbind and ypserv; the program allocated 
memory but did not free it. The bug was in the C library. 

yp_next no longer fails if the input key is zero length (null). 

/etc/yp/ypinit has been fixed. Previously, it was unable to detect an unset 
host name or domain name. 

The yp_bind function has been corrected to allow the code to work correctly 
when compiled on a DEC VAX. 

The bug in the t f tp server which caused file transfers to timeout has been 
fixed. 

Running out of process table space made a machine unable to accept new net¬ 
work connections making programs such as rsh and rlogin timeout. Under 
these circumstances, the internet daemon would eat up all the rest of the CPU 
cycles. 


The viand ex command : so (source) has been fixed. Using the source 
command to read and execute a file of vi commands caused vi to loop. 

The vt rof f formatter has been fixed. Previously, it used to generate floating 
exception messages when asked to draw boxes via -ms . BX commands. 

The error response of sendmail has been corrected. The error response of 
sendmail treated a temporary error like a permanent error. For example, the 
Release 2.0 responded Deferred: Bad file number on any temporary 
error involving SMTP. This is fixed. 
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4.7; Miscellaneous 
Software Fixes 
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dcheck no longer produces bogus errors after encountering a real disk error. 

The man command will now give the user a usage string citing the valid options 
instead of crashing. 

The /bin/test command, used from the Bourne shell, now recognizes the 
command-line arguments -b, -c, -g, -k, and -x. 

Ipd will now parse + entries in /etc/hosts. equiv. 

The ftp bug which used to cause files to overwrite has been corrected. 

The date computation in makedbm has been fixed. 

A spurious not on export list error could result from a remote mount 
from a gateway. 


A long line of input typed to a Suntools shell window no longer locks up that 
window. 

The double pr__destroY in libsuntool/gf xsw, c has been corrected. 

In the panel_public. c package in libsuntool, in a routine named 
shrink_to_f it (), two variables have to be initialized to zero. In the 
function panel_get 0 , a third argument has to be defined. 

In Release 2.0, sysdiag’s account name appears in /etc/passwd with a 
blank password field. This allows over-the-wire diagnostics but also allows a 
user to log in as sysdiag and become root. If you wish to prevent this, put 
a in the password slot of passwd file. 
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Changes from the 2.2 Software 


The following indicate changes made since the 2.2 Release. User programs may 
need to be re-linked or re-compiled to take advantage of these changes. 

5.1. Software Contents and The SunCGI R^erence Manual for the 2.3 Release is the corrected and revised 

Details of Changes edition of the previously published SunCGI Reference Manual. In particular, the 

chapter on input devices has be reorgnized to more accurately describe logical 
input devices. The appendix on the SunCGI - Pixwin interface has been 
improved. Many example programs have been added throughout the manual to 
give the reader templates from which to develop larger SunCGI. 

NOTE Please refer to SunCGI Reference Manual for Release 2.3 for any information 

regarding the CGI software including all changes and bug fixes from the 2.1 and 

2.2 releases. 

partial_polygon allows invisible edges. See the SunCGI Reference Manual for 

2.3 for a complete explanation. 

Bug Fixes for CGI character_orientation in the CGI libtrary had its arguments out of 

order. This has been fixed. 

Fortran ‘wrappers’ now have matching mallocs and ‘free’ calls. Previously, cer¬ 
tain FORTRAN CGI calls gobbled memory or caused segmentation violations. 
This has been fixed. 

CGI’s ‘gp_flag’ (which indicates that a Graphics Processor is present) is now 
explicitly reset if no GP is found. 

Partial polygon used to scale its coordinates when partial_polygon was called. 
This caused it to scale them incorrectly if multiple viewsurfaces were used. This 
has been corrected. 

If the ABSOLUTE specification_mode has been selected, scaled bundled attri¬ 
butes (line_width, perimeter_width, or marker_size) are no longer rescaled when 
the window size (or device_viewpoint) changes. Formerly, the user had to set 
these attributes again to have them set correctly. 

A small number of routines that are for internal use only have a ‘unique’ prefix 
‘gpl ’ or ‘_cgi_’. Other internal routines have been hidden to avoid collision 
with users’ names. 
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General Bug Fixes 
kernel 


c compiler 


inquire_text_extent no longer assumes that text path is always RIGHT. 

The ‘append text point’ is no longer up and to the right relative to the text path. 

Ellipse and elliptical perimeters are now rendered using perimeter attributes in all 
cases. 

CGI can access a CG2 device without it being /dev/fb. 

Short vertical lines no longer fail with BEST_FIT endstyle (displaying long 
vertical lines). This fixes patterned polygon or lectangel perimeters, as well as 
polyline. 

Text extent box now includes descenders. 

Text extent box now assumes text is at 0,0 as the standard says. 

Text can now rotate and thr text up vector and base vector need not be orthogonal 
(perpendicular). 

Text extent box is now correct for raster text 

Declarations for cgipw_ functions have been added to cgidef s. h. 

CGI lint library has been added. 


sys/rpc/subr_kudp. c ku_recvform removed a test for zero length 
mbufs. The test was causing zero length mbufs to slip by without being decre¬ 
mented from the socket recieved buffer count. This in turn caused a panic 
sbflushwhena sbf lush was done on the socket. This has been fixed. 

sys/nf s/nf s_vf sops. c nfs_statfs put in a test for uninitialized 
transfer size to avoid clobbering the transfer size set at mount rime. The symp¬ 
tom of this problem was a hung 3-Cora client talking to a Sun-3 server even 
though a nustint -o resize=2048 was done. The transfer size was 
overwritten the first time a statf s request was made to the server. This has 
now been fixed. 

The kernel use to send a bogus ‘Trace/BPT’ signal to a user process that was not 
being traced or debugged. This has now been fixed. This an additional fix to the 
‘Trace/BPT’ signal bug in Release 2.2 (See Chapter 4, Section 4.3- 
Miscellaneous). 


cc -a no longer produces errors because of the code -a inserts. Originally, 
the parentheses around conditions were causing the problem. The compiler was 
looking for a closing parentheses to match the one that comes right after the ‘for’ 
keyword, but it would skip over the opening parenthese that begins condition 1. 
Therefore, when it found the closing parenthese after condition 1, it assumed this 
was the closing parenthese for the entire construct. This bug has been fixed. 
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If a user wrote a program that made calls to getprotoent () or get- 
netent, the user’s program might fail because these two library routines were 
freeing memory that did not belong to them. This bug has been fixed. 


ie driver When the driver runs out of resources while attempting to transmit a packet, it 

puts it back on the output queue, so it can retry later. This did not always work. 
This bug has been fixed. 

The Intel chip imposes a minimum length requirement on buffers used to hold 
pieces of packets to be transmitted. The driver failed to meet this requirement, 
with the result that the chip would transmit part of a packet and then strave. The 
result was a truncated packet on the wire and could cause TCP connections to 
hang. This has now been fixed. 

Incoming packets sent from some kind of transceivers (common on DEC equip¬ 
ment) can cause the hardware surrounding the Intel Ethernet chip to interrupt the 
carrier detect signal momentarily. This causes the packet to be lost. The wor¬ 
karound for this is to delay the time when the chip starts to look for carrier detect 
until it is past the danger period. 
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Errata Pages for 2.0 Manuals 


Errata Pages for 2.0 Manuals. 53 

6.1. Converting Diskful Workstations to use NFS. 64 
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Errata Pages for 2.0 Manuals 


The following pages list errata from the 2.0 Programmer’s Reference Manual for 
SunCore (Part Number: Z00-ll65)y Programmer’s Reference Manual for 
SunCGl (Parj; Number: 800-1166), System Administration for the Sun- 
Workstation (Part Number: 800-1150) and Installing Unix on the SunWorkstation 
(Part Number: 800-1158). 
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Errata in the 2.0 Release 
of the 

Programmer’s Reference Manual for SunCore 



Page(s) 

Comments 

B-3 

In Section B-2, two additional device specifications for the GP board are necessary. 


gpldd A Sun-2/160 graphics display with a Graphics Processor option. 

gplpixwindd A color graphics window within the Suntools window environment 
running on a Sun-2/160 color graphics display with a Graphics Pro¬ 
cessor option. 


In addition, the sentence following these specifications that lists devices capable of 
hidden surface removal should include the new GP devices. 
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Errata in the 2.0 Release 
of the 

Programmer s Reference Manual for SunCGI 


THESE ERRATA PAGES ARE OBSOLETE. SEE 


SunCGI R^erence Manual 
Release 2.3 


Table 6-1 SunCGI Errara 



Page 

Comments 


2-3 

Section 2.1.2 should state that many failures during view surface initialization produce error 11, 
ENOWSTYP. For example, opening a device surface type PIXWINDD instead of CGPIXWINDD 
on a color pixwin, or using CG2DD when \h&/dev/cgtwo* surface is being used by suntools. 


2-5 

In Table 2-2, an additional device specification for the GP board is necessary. 

GPIDD for Sun-2/160 graphics display with optional Graphics Processor 

o 

2-16 

Section 2.3.2.1 should contain the following explanation: 

The default state is VDC_EXTENT. If clipping is not NOCLIP, output primitives are clipped 
to either the clip rectangle (if cf lag equals CLIP_RECTANGLE) or the full extent of VDC 
space (if cf lag equals VDC_EXTENT). The extent of VDC may be set with the 
vdc_extent function. 


2-19 

In Section 2.3.3.4, the extent argument is of the enumerated type Cexttype. The function 
specification is correct, but the text makes reference to an argument clear_extent incorrectly 
of type Cclip. The definition of type Cexttype is: 



typedef enuiti { 

CLIP_RECT, 

VIEWPORT, 

VIEWSURFACE 
} Cexttype; 


2-19 

In Section 2.3.3.5, the discussion of set_error_warning_mask should contain the follow¬ 
ing explanation: 

SunCGI defines no errors as FATAL. (POLL and INTERRUPT actions are therefore the 
same). The error number is always returned. A message is printed unless the action is 
NO_ACTION. 

Q 
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Table 6-1 SunCGI Errata — Continued 

Comments _ 

In SectioTr2.4.3 The sig_function argument to set_up_sigwinch is a pointer to a func¬ 
tion, The complete specification should be; 

Cerror set_up_sigwinch(name, sig_function) 

Cint name; 

Cint (*sig_function)(); /* signal handling function */ - 

The sig_f unction argument is called with a single argument: the name of the view surface 
with which it is associated by the call to set_up_sigwinch. This allows more than one view 
surface to share the same sig_function, and differentiate which view surface needs 
redisplay. 

Section 3.2.7 the discussion of bitblt_source_array should contain the following expla¬ 
nation: 

pixsource and pixtarget are pointers to pixrects which must already be created by 
the user with raem_creat e (see the Programmer’s Reference Manual for SunWindows). 
These pixrects must be the same depth as the view surface; 1-bit deep on a monochrome 
device, 8-bit on a color device. The source area of the view surface associated with name 
is saved into pixsource (at 0,0), possibly NOT-ed, depending on the drawing mode. 

The target area, after pixsource is applied to it, is read into pixtarget pixrect (at 

0 , 0 ). 


In Section 3.2.8, the second paragraph should say; 

pixpat is a pointer to a pixrect which must be created and initialized with the pattern 
by the application program, pixtarget is a pointer to a pixrect (with same depth as 
device) which must already be created by the user, using mem_create. The target area, 
after pixpat is applied to it, is read into the pixtarget pixrect (at 0,0). 

In Section 3.2.9, the first paragraph should say; 

bitblt_patterned_source_array replicates (using the current drawing mode) 
the pattern stored in pixpat to fill the area of the view surface determined by ox, oy and 
dx, dy. The source area of the view surface is read into the pixrect pointed to by pix¬ 
source (which must already be created by the user with same depth as device) at 0,0. 
The replicated pattern array is AND-ed into the pixsource, and possibly NOT-ed, depend¬ 
ing on the drawing mode. The resulting pixrect is copied to the view surface at ox, oy, 
using the current drawing mode. The target area, after the copy, is read into the pix¬ 
target pixrect If the replicated pattern array overlaps with the source array on the 
screen, the visual result depends on the current drawing mode. 

The sentence in Section 4.4.2.3 which says; 

All nonzero entries in colorind are set to 1. 

should say: 

For monochrome view surfaces, all nonzero entries in colorind are treated as 1 when 
used. 
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Table 6-1 SunCGI Errata — Continued 


Page _ 

4-12 New Section 4.4.2,6: 


Comments 


Cerror pattern_with_fill_color(flag) 

Cflag flag; /* ON to use nonzero pattern elements as fill color */ 

Binary patterns are a SunCGI extension that allow the same pattern to be applied in different 
colors, without redefining the pattern array. pattern_with_f ill_color sets a non¬ 
standard CGI state pattern with fill color. The default for f lag is OFF and each color value in a 
pattern table entry is used verbatim, as in standard GGI. When a pattern is used while 
pattern_with_f ill_color is ON, the pattern is considered to be a 2D array of flags: 
where the pattern element is nonzero, the current fill color is used, instead of the actual value of 
the pattern element. (Where flag is zero, a zero color index is used, just as when the flag is 
OFF.) 


4- 20 Section 4.6.1 should say: 

The default color lookup table size for a color device has 8 entries. The minimum and 
maximum color table entries are treated specially by pixwins and hence by SunCGI. If 
they are set to be the same value, the user’s values for these two entries are ftot/rignored: 
they revert to the "inverse" of the normal values: entry 0 becomes white, the maximum 
entry becomes black. 

5- 1 The following paragraphs are supplemental to the introduction of logical input devices. 

Each logical input device can be used in one of three ways, distinguished by the three 
EVENT input device states. To use input synchronously, the application program should 
call requestjnput. The program blocks until the operator fires a trigger associated with 
this device (or a timeout occurs). If timeout is -1, the request will wait forever. 

To receive input asynchronously, the initiate_request function should be used. 
This function initializes the device so that the measure from the next trigger activation 
will be recorded in the request register. The program does not block in REQUEST mode. 
Until the trigger fires, sample_input may be called to get the current measure of the 
input device. After the trigger fires, get_last_request_input will then return the 
request register (value) and status. 

To use queued input the enable_event s fiinction should be called. This fijnction ini¬ 
tializes the device so that trigger activations will result in input events being enqueued 
onto the event queue. Calls to await_event will return the first event in the event 
queue. If the event queue is EMPTY, it will wait for a trigger (or until timeout). A call to 
disable_e vents will terminate the queuing of input events. 

When initializing the locator or keyboard device, the the xypt field of the Cinrep 
structure must point to a Ccoor allocated by the application program. 
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Table 6 -1 Sun C GI Errata — Continued 


Comments 


The progfam example in Section 5-1 is wrong. It should be replace by the following example: 

#include <cgidefs.h> 

#define TEN SECONDS (10 * 1000 * 1000) /* timeout is in microseconds */ 


main() 


Cawresult stat; 

Ccoor point; 

Cinrep ivalue; 

Cint name; 

Cint trig; 

Cvwsurf device; 

device.dd = PIXWINDD; 

point.X = 16384; /* put cursor in the middle of the view surface */ 
point.y = 16384; 
ivalue.xypt = &point; 

open_cgi(); 

open_vw3(Sname, &device); 

initialize_lid(IC_LOCATOR, 1, &ivalue); . 

/* associate locator with mouse button 1 */ ' 

associate(2, IC_LOCATOR, 1); 

/* track with printer's fist: move cursor (fist) to initial point */ 
track_on(IC_LOCATOR, 1, 1, (Ccoorpair *)0, &ivalue); 

/* wait up to ten seconds for input */ 

request_input(IC_LOCATOR, 1, TEN_SECONDS, &stat, Sivalue, Strig); 
if (stat == VALID_DATA) 

printfC trigger activated at %d %d 0, 

ivalue.xypt->x, ivalue.xypt->y); 

else 

printfC trigger not activated 0); 

/* shut device off */ 
dissociate(2, IC_LOCATORr 1); 
release_input_device(IC_LOCATOR, 1) ; 

sleep(10) ; 
close_vws(name); 
close_cgi(); 


Trigger 6, LOC_STlLL, has been added. This trigger fires when the mouse doesn’t move for about 
l/5th of a second (or more). 
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Table 6-1 SunCGI Erra/o —Continued 


Page 

Comments 

_ 1 


5-11 The devise specification arguments for get_last_requested._input are wrong. The com¬ 
plete specification should be consistent with the other input routines. 


Cerror get_last_requested_input(devclass, devnum, valid/ sample) 

Cdevoff devclass; /* device class and number */ 

Cint devnum; 

Clogical *valid; /* device status */ 

Cinrep *sample; /* device value */ ■ • 

F-2 The name and pw arguments for open__cgi_pw are wrong. The complete specification should 

be: 

Cerror open_cgi_pw(pw, desc, name) 
struct pixwin *pw; /* pixwin */ 

Ccgiwin *desc; /* CGI pixwin descriptor */ 

Cint *name; 

F-2 All cgipw input and output primitives use screen (pixel) coordinates, for compatibility with 

pixwins. As described in Programmer's Reference Manual for SunWindows, pixel coordinates 
have the upper left corner as the origin for compatibility with Pixwins. Table F-1 should not con¬ 
tain reference to track:_on or track_of f; the functions cgipw_traclc_on and 
cgipw_track_of f do not exist. 

The bottom of page F-2 should say desc is a pointer to the pixwin descriptor filled in by the 
open_cgi_pw function. 
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Table 6-1 SunCGI£/'ra/<3 —Continued 


Comments 


The FORTRAN example program is wrong. Here is a version that works, 
program test 

parameter (ibignum=256) 

integer name 

character screenname* (ibignum) 
integer screenlen 
character windowname* (ibignum) 
integer windowlen 

integer windowfd _ 

integer retained 

integer dd 

integer cmapsize 

character craapname* (ibignum) 

integer cmaplen 

integer flags 

character ptr* (ibignum) 

integer noargs 

integer xc(10),yc(10) ,n 

integer xc2(2),yc2(2) 

data xc /O,-10,-1,-1,-15,15,1,1,10,0 / 
data yc 70,0,1,20,35,35,20,1,0,0 / 
data xc2 7-12,12/ 
data yc2 733,33/ 

call cfopencgiO 
dd = 4 

call cfopenvws(name,screenname,screenlen,windowname,windowlen, 
+ windowfd,retained,dd,cmapsize, 

+ cmapname,cmaplen,flags,ptr,noargs) 
call cfvdcext(-50,-10,50,80) 
n = 10 

call cfpolyline(xc,yc,n) 
n = 2 

call cfpolyline(xc2,yc2,n) 

call sleep(10) 

call cfclosecgiO 

call exitO 

end 

The calling sequence for bitblt_patterned_source_array should say 

bitblt_patterned_source_array(pixpat, px, py, pixsource, 
sx, sy, pixtarget, rx, ry, ox, oy, dx, dy, name) 
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Table 6-2 Functions not compatible with CGIPW mode 


Function 

Discussion 

vdc_extent 

cgipw’s VDC space is identical to screen space 

device_viewport 

use pw_region prior to open_cgi_pw 

clip_indicator 

when cflag is CLIP_RECTANGLE 

clip_rectangle 

Instead, use pw_region prior to open_cgi_pw 

clear_control 

All clear extents are identical 

open_vws 

Use open_cgi_pw 

close_vws 

Use close_cgi_pw 

close_cgi 

Use close__pw_cgi 
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Errata in the 2.0 Release 
of the 

System Administration for the SunWorkstation 



Page(s) 

Comments 

2 

In section 1,1 of the tutorial onFSCK-The Unix File System Check Program, the 
default block size for the 2.0 Release should be 4K with a hardcoded default block 


size of 4096. 

4-24 

In Section 4.3 when mail is sent, sendraail checks the files 
/etc/hosts . equiv and /usr/lib/mailhosts for the name of the host to 
whom the mail is being sent. If neither of these files contain the hostname, s end- 
mail forwards the mail to the mailhost machine specified in the host file. 
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Errata in the 2.0 Release 
of the 

Installing Unix on the Sun Workstation 


Page(s) 

Comments 

3-2 

If you have a 1/4" tape and the > prompt returns instead of Boot, the tape may need 
retensioning. Try entering; 


>b tape (0,0,100) 

Boot: rape (0,0,0) 

Boot: 

6-10 

If your standalone system is not attached to the net, or you are not using the yellow 
pages server, you will need to bypass the yellow pages in order to continue your 
installation of UNIX. Move /etc/ypbind to /etc/ypbind- by using the fol¬ 
lowing command: 


mv /etc/ypbind /etc/ypbind- 


o 



Asun 

microsystoms 


Revision A of 7 March 1986 



64 Release 2.3 Manual for the Sun Workstation 


Errata in the 2.0 Release 
of the 

Installing Unix on the Sun Workstation 
Insert Sheets for Chapter 10 



6.1. Converting Diskful Workstations to use NFS 

This section describes how to convert a diskful workstation to use NFS. 

The NFS enables diskful workstations to mount directories from other machines, thus reducing local disk storage 
needs and allowing them to share common resources. 

The conversion process in this section is designed specifically for diskful workstations. To convert servers and disk¬ 
less clients, use the instructions provided earlier in this chapter. 

This procedure uses examples from an upgrade where the diskful workstation named topnotch was upgraded to use 
NFS, and the system vfree is its NFS server. 


Use the following steps: 


(1) Record Vital Information 

Before you can proceed, you need to know: 



Your local machine name and internet address, your NFS server’s machine name and internet address, your user 
id number (uid) from tetdpasswd, and your domain name if you are going to use the yellow pages . See Chapter 
1 for descriptions of these items (except uid). For example: 


topnotch 192.9.4.53 {These are examples only 

vfree 192.9.4.54 do not use this information] 


(2) Dump 

Dump your entire disk(s). 

(3) Follow Install Manual Instructions 

Follow the instructions in Chapters 1 through 5 up until the point it tells you to run setup. Then, instead of running 
setup go to the next step. Be sure to boot the system in single user mode first: 

>b vmunix -s 


(4) Edit fstab 

Edit your letdfstab file. The entire file should look like the one below. Be sure to substitute the proper value for disk: 
Note that you may have to use the “ed” editor, as “vi” may not be available (See edil)). 


/dev/diskOa / 4.2 rw 1 1 

/dev/diskOg /private 4.2 rw 1 2 
nfs_server_name:/usr /usr nfs rw,hard 0 0 
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Be sure to replace nfs_server_name with the name of your NFS server. 

(5) Edit rc.local 

Edit the file rc.local. Replace noname with your machine name, and nodomainname with your domain name. If you 
do not use domains, leave the nodomainname alone. For example; 

/bin/hostname topnotch [Example - do not use this) 

/bin/domainname nodomainname [Note no domainname) 

(6) Edit hosts 

Add two lines with the following to your/etcihosts file: 
internet_address machinename 

NFS_server_in terne t_address NFSjserverjnachinename 

for example: 

192.9.4.53 topnotch [This is an example only: 

192.9.4.54 vfree do not enter this data] 

(7) Add to Server’s /etc/hosts 

Make sure your internet address and machine name are in the NFS servQt's I etc/hosts file. 

(8) Run newfs 

Do the following /etc!newfs (remember to substitute the proper value for disk): 
newfs /dev/rcfijArOg 

(9) Mount diskg 
Enter the following; 

mkdir /private 

/etc/mount /d.&v/diskQq /private 

This section assumes that the server contains links from /usr to /private (e.g. /usr/adm -> 

/private /usr/ adm). 

(10) Make new directories 

Use mkdir to create the following directories: 

/private/usr 
/private/usr/adm 
/private/usr/crash 
/private/usr/preserve 
/private/usr/spool 
/private/usr/tmp 
/private/usr/lib 
/private/usr/spool/mqueue 
/private/usr2 

Now create a symbolic by doing the following: 
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In -s /private/usr2 /usr2 



(11) Moveypbind 

Move /etc/ypbind to /etc/ypbind- 

(12) Reboot your machine 

Now, prepare your machine for halting, by syncing the disks several times take it down, and boot multiuser. Note that 
the default boot command (>b) should work. 
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Try out a few things to make sure they work, before you begin the next steps and start restoring your files. 

(13) Create files 

Use touch to create the'following new files; 

/private/us r/adxn/last log 
/private/usr/adm/messages 
/private/usr/adm/msgbuf 
/private/usr/adm/shutdownlog 
/private/usr/adm/usracct 
/private/usr/adm/wtmp 

(14) Restore files 

From the dump tape you made earlier, restore your home directory files to lusr2, which ismounted on the ’g’ parti¬ 
tion. Remember, files dumped as lusrijohn must be restored as /usr2/john. 

Next, restore the following files individually: 

Restore /usr/libicrontab to /private/usrilib/crontab. 

Restore /usr/lib/aliases to private/usr/lib/aliases. 

Restore all of /usr/spool to /private/usr/spool. 

(15) Edit crontab 

Edit the /private/usr/lib/crontab file you restored and make three changes: 1) remove or comment out my find com¬ 
mand that starts at ‘ 7” — the root. 2) remove or comment out any ‘calendar’ entry. 3) Change a line in crontab as 
follows: 

Change: 

15 4 * * * find /usr/preserve -mtime +7 -a -exec rm -f {} \; 

Change it by adding a ‘/’ (slash) at the end of preserve: 

15 4 * * * find /usr/preserve/ -mtime +7 -a -exec rm -f {} \; 

(16) Install sendmail 

Now, you must install sendmail as described in the "System Administration Manual". Note that the files 
/usr/lib/sendmail.main.cf and /usr/lib/sendmail.subsidiary.cf shonld already be in /usr/lib. 

(17) Edit passwd 

Next, edit your /etc/passwd to include the uid that you recorded above, and make sure that the home directory field for 
each user is /usr2 instead of /usr. Note that eventually you will want to assign passwords to both root and yourself; 
you can do this with passwd. 

For example, make sure the field looks like this: 

zippylOVceErnaql:1492:10:Zippy the Hacker:/usr2/zippy;/bin/csh 
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(18) Restore more files 



Now, restore the following files. Note that, unlike the files restored above, these return to their original locations. 
The files are; /etdprintcap, letcittys, letcittytype, letclremote (you may have others). 

If you do not plan to use the yellow pages, then also restore the following files :! etc! group, I etc! services, 

!etc!protocols,!etc!networks, and !etc!hosts. 

Now, restore other files peculiar to your disk. For example, lusriliblemacs should be restored to /usr. Note however, 
that almost all programs must be recompiled; 1.x binaries do not normally run on a 2.0 system. 
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Contents of get_arch_f¥ilQ 




This is a list of the differences between files in Release 2.2 and 2.0. 

/bin/test 

/dev/MAKEDEV 

/etc/gplcg2.1024.ucode 

/etc/gplcg2.1152.ucode 

/etc/gpconfig 

/etc/inetd 

/etc/mount 

/etc/nfsd 

/etc/showmount 

/etc/shutdown 

/etc/umount 

/etc/yp/makedbm 

/etc/ypbind 

/etc/ypserv 

/lib/ccom 

/lib/libc.a 

/usr/bin/adjacentscreens 

/usr/bin/clear_c61ormap 

/usr/bin/lockscreen 

/usr/bin/perfmon 

/us r/bin/screendump 

/usr/bin/screenload 

/usr/bin/tcov 

/usr/etc/in.tftpd 

/usr/etc/nfsstat 

/usr/etc/ping 

/usr/etc/rpc.mountd 

/usr/etc/rpc.yppasswdd 

/usr/etc/trpt 

/usr/include/gpl_jpwpr. h 

/usr/include/netinet/ip.h 

/usr/include/nfs/nfs.h 

/usr/include/nfs/nf s_clnt.h 

/usr/include/pascal/devincpas.h 

/usr/include/pixrect 

/usr/include/sun/fbio.h 

/usr/include/sun/gpio.h 

/usr/include/ufs/inode.h 
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/usr/lib/bb_count 
/usr/lib/font/ftS 
/usr/lib/font/fttS 
/usr/lib/libdbm.a 
/usr/lib/libpfc.a 
/usr/lib/libpixrect.a 
/usr/lib/lint/lint1 
/usr/lib/lint/llib-lc.In 
/usr/lib/lint/llib-lcgi 
/usr/lib/lint/llib-lcgi.In 
/usr/lib/lint/llib-lcore.In 
/usr/lib/lint/llib-lcurses.In 
/usr/lib/lint/llib-lm.In 
/usr/lib/lint/llib-lmp.ln 
/usr/lib/lint/llib-lpixrect.In 
/usr/lib/lint/llib-lsuntool.In 
/usr/lib/lint/llib-lsunwindow.In 
usr/lib/lpd 
/usr/lib/sendmail 
/usr/lib/sendmail.main.cf 
/usr/lib/sendmail,subsidiary.cf 
/usr/sys/OBJ/bwl_rop.o 
/usr/sys/0BJ/cg2_colorinap. o 
/usr/sys/0BJ/cg2_rop.o 
/usr/sys/OBJ/cgtwo.h 
/usr/sys/OBJ/cgtwo.o 
/usr/sys/OBJ/conf.o 
/usr/sys/OBJ/consfb.o 
/usr/sys/OBJ/gpl_colormap.o 
/usr/sys/OBJ/gpl_lcern_sync. o 
/usr/sys/OBJ/gpl_rop.o 
/usr/sys/OBJ/gpone.h 
/usr/sys/OBJ/gpone.o 
/usr/sys/OBJ/if.o 
/usr/sys/OBJ/if_ec.o 
/usr/sys/OBJ/if_ether,o 
/usr/sys/OBJ/if_ie.o 
/usr/sys/OBJ/if_loop.o 
/usr/sys/OBJ/ioconf.o 
/usr/sys/OBJ/ip_icmp.o 
/usr/sys/OBJ/ip_input .0 
/usr/sys/OBJ/ip_output.o 
/usr/sys/OBJ/kbd.o 
/usr/sys/OBJ/keytables .0 
/usr/sys/OBJ/kudp_fastsend.o 
/usr/sys/OBJ/machdep.o 
/usr/sys/OBJ/mem_rop.o 
/usr/sys/OBJ/mti .0 
/usr/sys/OBJ/nf s_server.o 
/usr/sys/OBJ/nfs_subr.o 
/usr/sys/OBJ/nfs_vfsops.o 
/usr/3ys/0BJ/subr_kudp.o 
/usr/sys/0BJ/uipc_socket2.o 
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/usr/sys/OBJ/nfs_vnodeops.o 
/usr/sys/OBJ/nf s_xdr.o 
/usr/sy3/0BJ/raw_ip.o 
/usr/sys/OBJ/sc .0 
/usr/sys/OBJ/sd.o 
/usr/sys/OBJ/st.o 
/usr/sys/OBJ/sys_generic.o 
/usr/sys/OBJ/tcp_debug.o 
/usr/sys/OBJ/tcp_input•o 
/usr/sys/OBJ/tcp_output.o 
/usr/sys/OBJ/tcp__subr .o 
/usr/sys/OBJ/tcp_tiiner .o 
/usr/sys/OBJ/tcp_usrreq.o 
/usr/sys/OBJ/trap.o 
/usr/sys/OBJ/tty.o 
/usr/sys/OBJ/udp_usrreq.o 
/usr/sys/OBJ/uf s__alloc .o 
/usr/sys/OBJ/ufs_dir.o 
/u5r/sys/0BJ/ufs_nd.o 
/usr/sys/OBJ/ufs_vnodeops.o 
/usr/sys/OBJ/vers.o 
/usr/sys/OBJ/vin_drum, o 
/usr / sys/OB J/vra_inachdep. o 
/usr/sys/OBJ/vin_j>t .o 
/usr/sys/OBJ/vin_text -o 
/usr/sys/OBJ/win.o 
/usr/sys/OBJ/windt .0 
/usr/sys/OBJ/xy.o 
/usr/sys/conf/GENERIC 
/usr/sys/conf/ND120 
/usr/sys/conf/README 
/usr/sys/conf/RELEASE 
/usr/sys/conf/SDSTl6OGP 
/usr/sys/conf/devices.sun 
/usr/sys/conf/files 
/usr/sys/conf/files.sun 
/usr/sys/conf/makefile.sun 
/usr/sys/conf/newvers.sh 
/usr/sys/sun/conf.c 
/usr/sys/sun/fbio.h 
/usr/sys/sun/gpio.h 
/usr/sys/sundev/scmb.h 
/usr/sys/sundev/streg.h 
/usr/ucb/ex 
/usr/ucb/ftp 
/usr/ucb/man 
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Optional Software for Release 2.3 


The following is a listing of the optional software available in the 2.3 release. 

1. FORTRAN compiler modules and libraries: 

./lib/fl 

./usr/include/f77/cgidefs77.h 
./usr/lib/f77passl 
./usr/lib/libF77.a 
./usr/lib/libF77_p.a 
./usr/lib/libI77.a 
./usr/lib/libI77_p .a 
./usr/lib/libcgi77.a 
Total Bytes; 633,730 

2. SunWindows executables and libraries: 

./usr/bin/clocktool (symbolic link to suntools) 

./usr/bin/coretool (symbolic link to suntools) 

./usr/bin/dbxtool 
. /usr/bin/fonttool 

./usr/bin/gfxtool (symbolic linkto suntools) 

./usr/bin/icontool 
. /usr/bin/perfmeter 

./usr/bin/shelltool (symbolic link to suntools) 

. /usr/bin/suntools 
./usr/bin/tektool 
./usr/bin/toolplaces 
./usr/lib/libsuntool.a 
./usr/lib/libsunwindow.a 
Total Bytes: 1,809,982 

3. SunCore and CGI libraries: 

./usr/inolude/cgicbind.h 

./usr/include/cgiconstants.h 
. /usr/include/cgidefs.h 
. /usr/include/cg|pw.h 
./usr/include/usercore.h 
. /usr/lib/libcgi.a 
./usr/lib/libcore.a 
./usr/lib/libcoresky.a 
Total Bytes: 1,693,213 
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4. SunWindows tool source and demonstration program source: 
./usr/include/suntool/charimage.h 
./usr/include/suntool/charscreen.h 
./usr/include/suntool/cheap_text.h 
./usr/include/suntool/emptysw.h 
./u5r/include/suntool/expand_name.h 
,/usr/include/suntool/fullscreen.h 
./usr/include/suntool/gfx_hs.h 
. /usr/include/suntool/gfxsw.h 
./uer/include/suntool/gfxswimpl.h 
./usr/include/suntool/icon.h 
./usr/include/suntool/icon_load-h 
./usr/include/suntool/menu.h 
./usr/include/suntool/msgsw.h 
./usr/include/suntool/optionsw.h 
./usr/include/suntool/optionsw_impl.h 
./usr/include/suntool/panel-h 
./usr/include/suntool/panel_impl.h 
./usr/include/suntool/selection.h 
./usr/include/suntool/tek.h 
./usr/include/suntool/teksw.h 
./usr/include/suntool/teksw_imp.h 
./usr/include/suntool/text_obj.h 
./usr/include/suntool/tool.h 
./usr/include/suntool/tool_hs.h 
./usr/include/suntool/ttysw.h 
./usr/include/suntool/tool_impl.h 
./usr/include/suntool/ttyansi.h 
./usr/include/suntool/ttysw_impl.h 
./usr/include/suntool/ttytlsw.h 
./usr/include/suntool/ttytlsw_impl.h 
./usr/include/suntool/user_profile.h 
./usr/include/suntool/wmgr.h 
./usr/src/sun/suntool/get_view_surface.c 
. /usr/src/sun/suntool/Makefile 
./usr/src/sun/suntool/tutorial/Makefile 
./usr/src/sun/suntool/toolmerge.c 
,/usr/src/sun/demo/Makefile 
./usr/src/sun/demo/flight_dat.h 
./usr/src/sun/demo/flight.c 
./usr/src/sun/demo/rotobj.c 
Total Bytes: 148,126 

5. Profiled libraries: 

./usr/lib/libc_p.a 

./usr/lib/libpfc_p.a 
Total Bytes: 270,270 

6. Versatec Printer software: 

./usr/lib/vwidth 

Total Bytes: 28,672 

7. Diagnostic programs: 
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. /usr/diag/sysdiag/.cshrc 
. /usr/diag/sysdiag/.login 
. /usr/diag/sysdiag/.suntools 
./usr/diag/sysdiag/.suntoolse 
. /usr/diag/sysdiag/devtest 
. /usr/diag/sysdiag/skyprobe 
•/usr/diag/sysdiag/probe 
./usr/diag/sysdiag/vmem 
./usr/diag/sysdiag/pmem 
. /usr/diag/sysdiag/disk 
./usr/diag/sysdiag/gpmtest 
./usr/diag/sysdiag/sptest 
. /usr/diag/sysdiag/ffpusr 
./usr/diag/sysdiag/gpmtest.all.2p 
./usr/diag/sysdiag/gpmtest.allbutgb.2p~ 

. /usr/diag/sysdiag/gpmtest. f if o__vme . 2p 
./usr/diag/sysdiag/gpmtest-fifo_vme_dec.2p 
./usr/diag/sysdiag/gpmtest.fpalu.2p 
./usr/diag/sysdiag/gpmtest.fpmult.2p 
./usr/diag/sysdiag/gpmtest.fprega.2p 
./usr/diag/sysdiag/gpmtest.fpregb.2p 
./usr/diag/sysdiag/gpmtest.gbnorm.2p 
./usr/diag/sysdiag/memtop 
./usr/diag/sysdiag/gpmtest.gbrmw.2p 
./usr/diag/sysdiag/gpmtest.int_flag.2p 
./usr/diag/sysdiag/gpmtest.pp_29116.2p 
./usr/diag/sysdiag/gpmtest.ppfifo.2p 
./usr/diag/sysdiag/gpmtest.ppprom.2p 
./usr/diag/sysdiag/gpmtest.scrpad.2p 
./usr/diag/sysdiag/gpmtest.shmem.2p 
./usr/diag/sysdiag/gpmtest.vme_byte.2p 
./usr/diag/sysdiag/gpmtest.vrae_read.2p 
./usr/diag/sysdiag/gpmtest.vme_read_byte.2p 
./usr/diag/sysdiag/gpmtest.vp_29116.2p 
./usr/diag/sysdiag/gpmtest.vpprom.2p 
./usr/diag/sysdiag/gpmtest.xoperand.2p 
./usr/diag/sysdiag/gpmtest.yoperand.2p 
./usr/diag/sysdiag/disktop 
./usr/diag/sysdiag/devtop 
./usr/diag/sysdiag/dev 
./usr/diag/sysdiag/setterm 
./usr/diag/sysdiag/endt 
./usr/diag/sysdiag/sysdiag 
./usr/diag/sysdiag/nextlog 
Total Bytes; 396,349 

8: Demonstration programs: 

./usr/demo/jumpdemo 
./usr/demo/framedemo 
./usr/demo/cframedemo 
./usr/demo/shaded 
./usr/demo/molecule 
./usr/demo/showmap 
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./usr/demo/show 
. /usr/demo/DATA/bottle.dat 
. /u s r/demo/DATA/egg.dat 
. /usr/demo/DATA/glass.dat 
. /usr/demo/DATA/icosa-dat 
. /usr/demo/DATA/mtxs.rotobj 
. /usr/detno/DATA/pyramid.dat 
./usr/demo/DATA/rings.vecs 
. /usr/demo/DATA/shuttle,vecs 
. /usr/demo/DATA/socbal.dat 
. /usr/demo/DATA/space.dat 
. /usr/demo/DATA/string.vecs 
. /usr/demo/DATA/testmol 
./usr/demo/DATA/vw.vecs 
./usr/demo/READ_ME 
./usr/demo/draw 
,/usr/demo/stringart 
./usr/demo/suncube 
./usr/derao/rotobj 
./usr/demo/flight 
./usr/demo/bouncedemo 
./usr/demo/spheresdemo 
Total KBytes: 3915 

9: Games: 

./usr/games/chesstool 
./usr/games/gammontool 
Total KBytes: 485 

10: Online reference manual pages: 

./usr/man/man8/gpconfig.8 
./usr/man/man8/mount.8 
./usr/man/man4/gpone.4s 
./usr/man/man4/st.4s 
./usr/man/manl/toolplaces.1 
./usr/man/man2/nfamount.2 
Total KBytes: 22 

11: Various bootable diagnostic programs 
./stand/gpl.2.diag 
./stand/diag 
Total Bytes: 464, 8.96 
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Insert Pages for 2.0 Reference Manuals 


The following pages are reference manual pages for Commands Reference 
Manual for the Sun Workstation (Part Number: 800-li.72) and the System Inter¬ 
face Manual for the Sun Workstation (Part Number: 800-1173). 

How you handle the pages is up to you. We recommend inserting them directly 
into your 2.0 manuals (copying them if necessary); they are numbered accord¬ 
ingly. 

New Pages 


gpone{AS) 

gpconfig{Z) 

nfsmount(2) 

mount{S) 

sr(4S) 

toolplaces(l) 


— . Sun-2/160 color graphics processor interface 

— initialize the Graphics Processor 

— revised 

— revised 

— revised 

— revised 
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GP0NE(4S) 


SPECIAL FILES 


GP0NE(4S) 


NAME 

gpone - Sun-2/160 color graphics processor interface 
SYNOPSIS 

gponeO at ftibO csr vme busmem 0x210000 priority 3 
DESCRIPTION 

The gpone interface provides access to the optional GP graphics processor board. 

gpone supports the FBIOGTYPE ioctl which a program can use to inquire as to the characteristics of the 
display device; see fbio (4s). 

gpone supports the FBIOGPIXRECT ioctl which allows SunWindows to run on it; see fbio (4s). 

The hardware consumes 64 kilobytes of VME bus address space. The GP board starts at standard address 
0x210000 and must be configured for interrupt level 3. 

FILES 

/dev/gpone [0-3 ] [abed] 

SEE ALSO 

fbio (4s), mmap (2) 


Sun Release 3.0 


Last change: 2 May 1985 
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GPC0NFIG(8) 


MAINTENANCE COMMANDS 


GPCONFIG(8) 


NAME 

gpconfig - initialize tlte Graphics Processor 
SYOPNSIS 

/etc/gpconfig gpunit [ [-b] {-i\fbunit... ] 

DESCRIPTION 

gpconfig binds cgiwo frame buffers to the Graphics Processor (GP), and loads and starts the appropriate 
microcode in the GP. For example, the command line: 

/etc/gpconfig gponeO cgtwoO cgUvol 

will bind the frame buffer boards cgtwoO and cgtwol to the Graphics Processor gponeO . The devices 
IdevIgponeOa and /dev/gponeOb will then refer to the cornbination of gpone and cgtwoO or cgtwol respec¬ 
tively. 

The same cgtwo frame buffer cannot be bound to more than one GP. 

All cgtwo frame buffer boards bound to a GP must be configured to the same width and height. 

Note: The gpconfig command should be placed in the file letctrc.local if the GP is used regularly. 

Note: It is inadvisable to run the gpconfig command while the GP is being used. Unpredictable results may 
occur. If it is neccessary to change the frame buffer bindings to the GP (or to stop using the GP alto¬ 
gether), bring the system down gently, boot single user, and edit the gpconfig line in the letc/rc.local file 
and bring the system back up multiuser. 

OPTIONS 

-b Configure the GP to use the Graphics Buffer as well. Note: Currently only one GP / frame buffer 
binding is allowed to use the graphics buffer at a time. 

-f Indicates that the next frame buffer specified is to be used for Idevijb as well. 

FILES 

/dev/cgtwo[0-9] 

/dev/fb 

/dev/gpone[0-3][abcd] 

/etc/gpicg2.1024. u code 
/etc/gpicg2.1152.ucode 
/etc/rc.local 

SEE ALSO 

cgtwo(4S), gpone(4S) 
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NFSM0UNT(2) 


SYSTEM CALLS 


NFSM0UNT(2) 


NAME 

nfsmount - mount an NFS file system 
SYNOPSIS 

#include <netinet/in.h> 

#include <nfs/nfs,h> 

nfsmount(addr, fh, dir, flags, rsize, wsize) 

struct sockaddrjn *addr; 

fliandlej *fh; 

char *freq; 

int flags; 

int rsize; 

int wsize; 

DESCRIPTION 

Nfsmount mounts an JVFS(4) file system on the directory dir. Addr is the UDP{4) address of the server that 
owns the file system to mount. Fh is a file handle, obtained from the server, to identify the root directory 
on the server that is being mounted. 

The flags argument contains mount flag bits. The NFSMNTJiDONLY flag tells whether the file system can 
be written on; if it is 0 writing is allowed, if non-zero no writing is done. 

The NFSMNT_SOFT flag determines whether the remote file system is mounted hard or soft. A soft mount 
causes an error to be returned when a remote access times out. Hard mounts cause the access to retry until 
the server responds. A value of 1 indicates a soft mount. 

The NFSMNTJRSIZE and NFSMNT_\VSIZE flags tell whether the rsize and wsize parameters are valid. If 
a flag is set the coresponding parameter is used to set the number of bytes sent in a read or write operation. 

RETURN VALUE 

Nfsmount returns 0 if the action occurred, -1 if some error occurred. 

ERRORS 

Nfsmount will fail when one of the following occurs: 

[EPERM] The caller is not the super-user or the path name given for dir contains characters with 

the high bit set. 

[ENAMETOOLONG] 

The path name for dir is too long. 

[ELOOP] Dir contains a symbolic link loop. 

[ETIMEDOUT] The server at addr is not accessable. This can only happen if the hard flag is set. 
[ENOTDIR] A component of the path prefix in dir is not a directory. 

[EBUSY] Another process currently holds a reference to fh. 

SEE ALSO 

mount(2), unmount(2), mount(8) 


Sun Release 3.0 


Last change; 1 February 1985 


63 



c 


c 








MOUNT(8) 


MAINTENANCE COMMANDS 


MOUNT(8) 


NAME 

mount, umount - mount and dismount filesystems 

SYNOPSIS 

/etc/mount 
/etc/mount -p 
/etc/mount -a[fv][t type ] 

/etc/mount [ -frv][to type options ] [ fsname ] [dir] 

/etc/umount [ -av ] [ fsname 1 dtr ]... 

DESCRIPTION 

Mount announces to the system that a filesystem/sn^ime is to be attached to the file tree at the directory dir. 
The directory dir must already exist. It becomes the name of the newly mounted root. The contents of dir 
are hidden until the filesystem is unmounted. If fsname is of the form hostipath the filesystem type is 
assumed to be nfs{d). 

Umount announces to the system that the filesystem fsname previously mounted on directory dir should be 
removed. Either the filesystem name or the mounted-on directory may be used. 

Mount and umount maintain a table of mounted filesystems in letcimtab, described in mtab{$). If invoked 
without an argument, mount displays the table. If invoked with only one of fsname or dir mount searches 
letcifstab for an entry whose dir or fsname field matches the given argument. For example, 
mount /usr 
and 

mount /dev/xyOg 
are shorthand for 

mount /dev/xyOg /usr 
if this line is in letcifstab 

/dev/xyOg /usr 4.2 rw 1 1 

MOL’NT OPTIONS 

-a Attempt to mount all the filesystems described in letcifstab. In this cast, fsname and dir are taken 
from letcifstab. If a type is specified all of the filesystems in letcifstab with that type will be 
mounted. 

-0 The next argument is a string that specifies mount options. Valid options are: ro, rw, quota, 
noquota, hard, soft, rsize=n, and wsize=n. Hard, soft, rsize=n and wsize=n only make sense on 
n/s(4) filesystems. Options are separated by commas. The options ro and rw stand for read-only 
and read-write; rw is the default. Since quotas are not implemented, noquota is the default. With 
a hard remote mount, mount tries forever if the mountdfZc) server does not respond. Once the 
filesystem is mounted, access requests will retry forever if the nfsd{S) server does not respond. 
Hard is the default. With a soft remote mount, if the mountd{ic) server does not respond, mount 
forks a background copy to retry forever. Once the soft mount completes, access requests will fail 
with [ETIMEDOUT] if the nfsd{Z) server does not respond. The rsize^n and wsize^n options can 
be used to set the number of bytes in a read or write operation on nfs{A) filesystems. 

-r Mount the specified filesystem read-only. This^ is a shorthand for: 
mount -0 ro fsname dir 

Physically write-protected and magnetic tape filesystems must be mounted read-only, or errors 
will occur when access times are updated, whether or not any explicit write is attempted. 

-t The next argument is the filesystem type. The accepted types are: 4.2, nfs, and pc; see fsiab{5) for 
a description of the legal filesystem types. 

-f Fake a new letcimtab entry, but do not actually mount any filesystems. 

-p Print the list of mounted filesystems in a format suitable for use in letcifstab. 

-V Verbose — mount displays a message indicating the filesystem being mounted. 
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UMOUNT OPTIONS 

-a Attempt to unmount all the filesystems currently mounted. In this case, fsname is taken from 
letcimtab. 

-V • Verbose — umount displays a message indicadng the filesystem being unmounted. 

EXAMPLES 

moun t /dev/xyOg /usr mount a local disk 

mount -ft 4.2 /dev/ndO / fake an entry for nd root 

mount -at 4.2 mount all 4.2 filesystems 

mount -t nfs serv:/usr/src /usr/src mount remote filesystem 

mount serv:/usr/src /usr/src same as above 

mount -o hard serv;/usr/src /usr/src same as above but hard mount 

mount -p > /etc/fstab save current mount state 

HLES 

/etc/mtab mount table 

/etc/fstab filesystem table 

SEE ALSO 

mount(2), nfsmount{2), unmount(2), fstab(5), mountd(8c), nfsd(8c) 

BUGS 

Mounting filesystems full of garbage will crash the system. 

No more than one user should mount a disk partition "read-write" or the file system may become corrupted. 
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NAME 

St - Driver for Sysgen SC 4000 Tape Controller 
SYNOPSIS 

controller scO at mbO csr 0x80000 priority 2 

controller scO at mbO csr vme busmem 0x200000 priority 2 vector scintr 64 
tape stO at scO drive 32 flags 1 

DESCRIPTION 

In the synopsis lines above, the first line specifies the first SCSI controller .on a Sun-2/120 or Sun-2/170; the 
second specifies the first such controller on a Sun-2/160. The last line sp^ifies the first tape drive on the 
first SCSI controller in a system. 

The Sysgen tape controller is a SCSI bus interface to a streaming tape drive. It provides a standard tape 
interface to the device, see mtio(4), with some deficiencies listed under BUGS below. To utilize the QIC 
24 format, access the logical device that is eight above the default physical (QIC 11) device (i.e. rstO = 
QIC 11, rst8 = QIC 24). 

FILES 

/dev/rst[0'3] QIC II Format 

/dev/rsi[8-ll] QIC 24 Format 
/dev/nrst[0-3] non-rewinding 

SEE ALSO 

mtio(4) 

Sysgen SC4000 Intelligent Tape Controller Product Specification 

Archive Intelligent Tape Drive Theory of Operation, Archive Corporation (Sun 8000-1058-01) 

Archive Product Manual (Sidewinder 1/4" Streaming Cartridge Tape Drive) (Sun 800-0628-01) 

DIAGNOSTICS 

St*: tape not online. 

St*: no cartridge in drive. 

St*: cartridge is write protected. 

St*: format change failed. 

St*: device not supported. 

BUGS 

The tape cannot reverse direction so the BSF and BSR ioctls are not supported. 

The FSR ioctl is not supported. 

Most disk I/O over the SCSI bus is prevented when the tape is in use. This is because the controller does 
not free the bus while the tape is in motion (even during rewind). 

When using the raw device, the number of bytes in any given transfer must be a multiple of 512. If it is 
not, the device driver returns an error. 

The driver will only write an end of file mark on close if the last operation was a write, without regard for 
the mode used when opening the file. This will cause empty files to be deleted on a raw tape copy opera¬ 
tion. 

Some older systems may not support the QIC 24 device, and may complain (or exhibit erratic behavior) 
when the user attempts a QIC 24 device xcess. 
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NAME 

toolplaces - show current window tool locations, sizes, and other attributes 
SYNOPSIS 

toolplaces ^-ujolO ] [ -help ] 

DESCRIPTION 

toolplaces generates position, size, label, and program attributes for the windows running on a window sys¬ 
tem screen at the time of execution, (toolplaces doesn’t work when the window system isn’t running.) 

Many people redirect standard output from toolplaces to the .suntools file, so as to reuse the current win¬ 
dow system attributes each time they execute suntools, the window system program. 

For each window on the screen at execution time, toolplaces shows; 
the tool name 

the "open" window position 
the size of the window in pixels 
the "closed," or icon, window position 
an indicator of whether the window is open or closed 
the label at the top of the window 
the name of the program running in the window, if a 
program is running there 

any flags or options to a program running in the window 

toolplaces describes each window on one output line, as long as necessary, using the current suntools for¬ 
mat. 

Current suntools format consists of window tool descriptions, one per line, as in this example (the \ indi¬ 
cates that the current line continues on the next line): 

clocktool -Wp 120 120 -Ws 122 55 -WP 1086 826 -Wi \ 

-W1" open clock" -S -r -d wdm 
shelltool -Wp 0 510 -Ws 490 343 -WP 256 836 \ 

-Wl "Task Window: /bin/csh" /usr/local/emacs task.file 
sheUtool -Wp 491 795 -Ws 580 87 -WP 0 836 -C 
shelltool -Wp 491 166 -Ws 650 567 -WP 702 836 \ 

-Wl due rlogin due 

SheUtool -Wp 0 0-Ws 650 525-WP 64 836 \ 

-Wl "SmaU Window; /bin/csh" 
shelltool -Wp 501 0 -Ws 650 812 -WP 128 836 \ 

-Wl "Big Window: /bin/csh" 

OPTIONS 

-u Shows the updated window tool information in the order that you originally specified it. 

-o Shows window tool information in the old suntools format for window attributes, but 

specifies the appropriate tool names for each tool. 

-O Shows window tool information in the old suntools format for window attributes, speci¬ 

fying toolname as the name for each tool. 

-help Shows help information preceding tool attributes. 

FILES 

'/.suntools Format file for suntools window system program. 

SEE ALSO 

suntools(l) 

Windows and Window-Based Tools: Beginner’s Guide 
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The following pages are to be inserted as an appendix to the Programmer’s Reference Manual for 
SunWindows. 

The SunWindows software provides a rich basis for designing custom user-interfaces. With the window 
system, the programmer can share the screen’s "real estate" amongst several virtual screens called win¬ 
dows. Each of these windows is essentially its own state machine, and so windows can be sensitive to 
programmer specified input events and take any number of actions in response to the events. Most of the 
time an input eventually results in some change in the window itself — sometimes drawing or writing 
something new in the window, and other times changing the window’s state with respect to the entire 
window system. 

With software this sophisticated, sometimes it is hard at first to get a handle on the data structures and 
library routines that make up the windows system. We feel that programming examples are the best way 
to show how to access specific data structures and call specific routines. Also, programming examples 
often give a good sense of what SunWindows is intended to do. The Programmer’s Tutorial to SunWin¬ 
dows gives several good examples for beginners. 

This document is meant as a supplement to the Tutorial with more advanced examples. None of the pro¬ 
grams are useful except as examples of a specific facet of SunWindows. They are designed to be short 
and to the point. The program listings included cover the following subjects: . 

• How to use timers in a tool_select () call (timertool. c) 

• How to change icons dynamically (changing_icon. c) 

• How to find newly exposed area in a window after window damage occurs (rect lists . c) 

• How to customize subwindow layout in a window {layout. c) 

• How to manipulate the colormap and color bit-planes in a color window 
(onewaytomakeacolorbar. o, anotherwaytomakeacolorbar.c, animation.c) 

• How to use the tool_parse_all () call (par se_all. c) 

« How to find the root window file descriptor from any window (findroot.c) 

Each program has approximately fifty lines of code (not counting comment lines, of course); many of 
which are copied from one program to the next. We suggest typing in the programs to help familiarize 
yourself with the data structures and calls, and so you can see the programs work. Further, we hope you 
use these programs as building blocks for your own experimentation with the window system. Each pro¬ 
gram contains comments explaining how the program works in general. For more information on data 
structures and routines used, please refer to the SunWindows Reference Manual . 
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This program illustrates how to use subwindow timers. These are briefly described in Section 6.3.1 of the 
SunWindows Reference Manual. 

Each subwindow is described by a toolsw structure. One field in that structure is a pointer to a 
toolio structure-,-one of the fields in THAT struct is a pointer to a timeval structure. A timeval has the 
following definition (see /usr/include/sys/time .h) : 

struct timeval { 

long tv_sec; 

long tv_usec; 

}; 

t v__sec and tv_usec specify a number of seconds and microseconds. 

In a toolio, the timeval pointer field is called tio_t inter . Ordinarily its value is NULL. When its 
value is non-null, then the timeval gives an amount of time for tool_select to wait for input events in the 
relevant subwindow. If the timer expires before an input event occurs, then control passes to the 
subwindow’s selected routine, just as if there had been an input event. The way to tell whether it was an 
input event or a timeout that activated the selected routine is to check the fields in timeval. They are 
dynamically decremented, so if they are both zero you know that a timeout has happened. 

This tool has a single subwindow. When you click the left mouse button, it activates a half-second timer 
in the subwindow. When the timer times out, the cursor image is changed and the timer is restarted. This 
goes on until you click the left mouse button again, at which point the tool goes into its original state, 
waiting for a click but not timing anything. 

To compile: 

cc timertool.c -o timertool -Isuntool —Isunwindow -Ipixrect 
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tinclude <stdio.h> 

#include <suntool/tool_hs.h> 
#include <sunt^ool/insgsw.h> 

#define TIMING 1 

#define NOT_TIMING 2 

struct tool *tool; 

struct toolsw *subwin; 

struct msgsubwindow *msw;, . 

struct pixfont *font; 

struct inputmask im; 

struct timeval timeval; 

int sigwinchcatcher () , selectedO; 

int state; 

struct cursor *cursor_array[8]; 
int cursor index; 


/* Values for "state" */ 


/* The tool */ 

/* The subwindow */ 
/* Ditto */ 


/* Pointers to 8 possible cursors */ 
/* Index of current cursor (0-7) */ 


/* The cursors. See section 4.8.1. of the SunWindows Manual. */ 
DEFINE_CURSOR(curO, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF, 
OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(curl, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,0 xFE7F, 
0xFE 7F,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur2, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFCSF,OxFCSF, 
OxFCSF,OxFCSF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur3, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFSlF,0xF81F,0xF81F, 
OxFSlF,OxFSlF,0xF81F,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur4, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFOOF,OxFOOF,OxFOOF,OxFOOF, 
OxFOOF,OxFOOF,OxFOOF,OxFOOF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur5, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,0xE007,0xE007,0xE007,0xE007,OxE007, 
OxE007,0xE007,0XE007,0XE007,0XE007,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur6, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxCOOS,OxCOOS,OxCOOS,OxCOOS,OxCOOS,OxCOOS, 
OxC003,OxC003,OxCOOS,OxC003,OxC003,0xC003,OxFFFF,OxFFFF); 
DEFINE_CURSOR(Cur7, 7, 7, PIX_SRC, 

OxFFFF,0x8001,0x8001,0x8001,0x8001,0x8001,0x8001,0x8001, 
0x8001,0x8001,0x8001,0x8001,0x8001,0x8001,0x8001,OxFFFF); 

main() 

{ 

state = NOT_TIMING; 
font = pw_pfsysopen0 ; 

/* Create the tool. */ 

tool = tool_make(WIN_LABEL, "Timer Example", 0); 
if (tool == NULL) { 
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} 


fputs("Can't make the tool.O, stderr); 
exit (1 )■ ; 


/* Create and init the subwindow. */ 
subwin = msgsw_createtoolsubwindow(tool,""/ 

TOOL_SWEXTENDTOEDGE, TOOL_SWEXTENDTOEDGE, 

"Click left button to start timing operation.", font); 
if (subwin == NULL) { 

fputsC'Can't make the subwindow.0, stderr); 
exit(2); 

1 

msw = (struct msgsubwindow *)subwin->ts_data; 
subwin->ts_io.tio_selected = selected; 

/* Set up input mask to respond to left-button clicks. */ 
input_imnull(&im); 

win_setinputcodebit(&im,MS_LEFT); 

win_setinputmask(subwin->ts_windowfd, &im, NULL, WIN_NULLLINK); 


/* Init the array of cursor-pointers. 
cursor_index = 0; 
cursor_array[0] = &cur0; 
cursor_array[1] = &curl; 
cursor_array[2] = &cur2; 
cursor_array[3] = &cur3; 
cursor_array[4] = &cur4; 
cursor_array[5] = £cur5; 
cursor_array[6] = &cur6; 
cursor array[7] = &cur7; ■ 


*/ 


/* Install the tool */ 

signal(SIGWINCH, sigwinchcatcher); 

tool install(tool); 


/* Main loop. */ 
tool_select(tool,0); 

/* Clean up */ 
tool_destroy(tool); 
exit(0); 


In this routine, there is a left-button click, or a timeout. 

If you are in NOT_TIMING state, then it can only have been a click. In this case go to TIMING state 
and set up the timer for 1/2 second (500,000 microseconds). 

If you are in TIMING state, you will have to figure out if you got a timeout or a click. As mentioned 
above, you do this by seeing if both fields in the timeval are zero. If so, restart the timer and change 
the cursor. If not, de-activate the timer and switch to NOT_TIMING state. 
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selected!) { 

struct inputevent ie; 


} 


"if (state == NOT_TIMING) ( 

input_readevent(subwin->ts_windowfd, &ie); 

state = TIMING; /* Change state */ 

tiineval .tv_sec = 0; 
timeval.tv_usec = 500000; 

subwin->ts_io.tio^timer = stimeval; /* Start timer */ 

msgsw_setstring(msw, 

"Click left button tcvhalt timing operation."); 


} 

else { /* TIMING state */ 

if (timeval.tv_sec == 0 && /* If got timeout */ 

timeval.tv_usec == 0) { 

timeval.tv_usec = 500000; /* Restart timer */ 

cursor_index = (cursor_index+l) % 8; /* Update */ 

win_setcursor(subwin->ts_windowfd, /* the */ 

cursor_array[cursor_index]); /* cursor */ 

} 

else { /* Not timeout, must be click */ 

input_readevent(subwin->ts_windowfd, &ie); 
subwin->ts_io.tio_timer = NULL; /* Deactivate timer */ 
state = NOT_TIMING; /* Change state */ 

msgsw_setstring(msw, 

"Click left button to restart timing operation."); 

1 


} 


/* Standard SIGWINCH handler. */ 
sigwinchcatcher() 

{ 

tool_sigwinch(tool); 

} 


This program illustrates how to create an icon without the icontool facility, and how to change it 
dynamically. 

The icon’s image is a 64x64 pixrect. After we create it and draw in it (the image is a simple checkerboard 
pattern), we set up an icon structure. When we create the tool, we specify a pointer to that icon 
structure. 

The tool consists of a single message subwindow. We set up a half-second timer in the subwindow. 
Please see timertool.c elsewhere in this package for details on using timers. When the timer goes off, we 
check to see if the tool is in iconic form. If so, we toggle the icon’s image by XORing its pixrect with an 
all-I’s pattern. 

Q 
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To compile: 

:cc changing_icon.c -o changing_icon -Isuntool 


-Isunwindow 


-Ipixrect 



#include <stdio.h> 

♦include <suntool/tool_hs.h> 
♦include <suntool/msgsw.h> 


struct tool *tool; 

struct toolsw *msw; 

struct pixfont *font; 

struct icon icon; 

struct pixrect *icon_mpr; 

struct timeval timeval; 

int sigwinchcatcher () , selectedO; 


/* The tool itself */ 

/* The message subwindow */ 

/* Font for writing in msg subwindow *, 
/* The icon. */ 

/* Memory pixrect for the icon */ 

/* The timer */ 


main(argc,argv) 
int.argc; 
char **argv; 

{ 

/* Create and init the icon's memory pixrect. */ 
icon_mpr = mem_create(64, 64, 1); 
if (icon_mpr == NULL) { 

printf("Aborting: cannot create icon's memory pixrect.0); 
exit(1); 

}; 

pr_rop(icon_mpr, 0,0,32,32, PIX_SET, NULL,0,0); 
pr_rop(icon_mpr, 32,32,32,32, PIX_SET, NULL,0,0); 



/* Init the icon. */ 

icon.ic_width = icon.ic_height = 64; 

icon.ic_baokground = NULL; 

icon.ic_gfxrect.r_left = 0; 

icon.ic_gfxrect.r_top = 0; 

icon.ic_gfxrect.r_width = 64; 

icon . ic_gf xrect. r_height == 64; 

icon.ic_mpr = icon_mpr; 

icon.ic_textrect.r_left = 0; 

icon.ic_textrect.r_top = 0; 

icon.ic_textrect.r_width = 0; 

icon.ic_textrect.r_height = 0; 

icon.ic_text = NULL; 

icon.ic_font = NULL; 

icon.ic_flags = ICON_BKGRDGRY; 


/* Create the tool struct. */ 

tool = tool_create("Changing-Icon Tool", TOOL_NAMESTRIPE, NULL, 
if (tool ““ NULL) { 
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printf("Aborting: cannot create tool.O); 
exit(1); 


/* Create and init the subwindow. */ 
font = pw_pfsysopen0 ; 

msw = msgsw_createtoolsubwindow(tool, TOOL_SWEXTENDTOEDGE, 

TOOL_SWEXTENDTOEDGE, "Please make me iconic.", font); 
if (msw ==.NULL) { 

printf("Aborting: cannot create subwindow.0); 
exit(1)/ 

} 

msw->ts_io.tio_selected = selected; 

timeval.tv_sec =0; /* Set up the timer */ 

timeval.tv_usec = 500000; 
msw->ts io.tio timer = stimeval; 


/* install the tool */ 

signal(SIGWINCH, sigwinchcatcher); 

tool install(tool); 



/* Main loop. */ 
tool select(tool,0); 


/* clean up */ 
tool_destroy(tool); 
exit (0) ; 


} 



/* Routine to handle SIGWINCH. */ 
sigwinchcatcher() 

{ 

tool_sigwinch(tool); 

} 

This is the selected routine. Since there is no input mask to select any input events, the only way to get 
here is if the timer times out. We restart the timer and, if the tool is in iconic state, we invert the icon. In 
order to update the icon’s image as it appears on the screen, we have to call tool_display. (See p. 
6-8 of the SunTools Manual for an explanation of the tl_flags field in the tool struct; we check 
this field when we see whether or not the tool is iconic. See p. 6-22 for an explanation of 
tool_di splay.) 
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selected() 

{ 

timeval.tv_usec = 500000; 

^if ((tool->tl_flags & TOOL_ICONIC) == 0) 
return(0); 

timeval.tv_usec = 500000; 

pr_rop(icon_mpr, 0,0,64,64,PIX_NOT(PIX_DST),NULL,0,0); 
'tool_display(tool); 

} 


This program demonstrates how to find out where a window has been 
damaged. "Damage" occurs either because the window size has changed 
or because windows above the window this program makes go away. 

For more information, see Chpt. 3 and Appendix A of the SunWindows 
Reference Manual (Revision G — 2.0 release). 

Each time this program recieves a SIGWINCH, it clears the entire 
window, loads in the clip list which tells what window "real estate" 
has been exposed, and draws boxes around each new piece of real 
estate. 

This is the technique used by a program like the shelltool to repaint 
after window damage occurs. In a tty subwindow, a buffer of all the 
characters on the screen is maintained. When the rectlist indicates 
there is new exposed area in the window, the.tty subwindow translates 
the comers of the damage in pixel coordinates to the comers in row 
and column coordinates. Then it simply re-writes the rows and columns 
that have been exposed. You can observe this by covering and uncovering 
a shelltool and watching the way it re-paints. 
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To compile: 

machine% cc rectlists.c -o rectlists -Isuntool -Isunwindow -Ipixrect -IiTl 

#include <stdio.h> 

#include <suntool/tool_hs.h> 

#include <suntool/gfxsw.h> 

main(argc, argv) 
int argc; 
char **argv; 


int height, width, vertical__line = 0; 

int xO, xl, yO, yl; 

struct rect rect; 

struct rectnode *rectnode; 

struct rectlist *rectlist; 

/* set up a graphics subwindow */ 

struct gfxsubwindow *gfx => gfxsw_init (0, argv); 

struct pixwin *win = gfx->gfx_pixwin; 

for (;;) { 

if (gfx->gfx_flags & GFX__DAMAGED) { ■ 

/* check if window size changed */ 
height = win_getheight(gfx->gfx_windowfd); 
width = win_getwidth(gfx->gf x_windowfd); 

/* clear the window */ 

pw_writebackground(win, 0, 0, width, height, PIX_CLR) 

/* set up new clip list & lock window during fix */ 
pw_damaged(win); 

rectlist = &win->pw_clipdata->pwcd_clipping; 
rl_rectoffset (rectlist, &rectlist->rl__bound, &rect); 
pw_lock(win, &rect); 

/* check if a window has been removed */ 
for (rectnode = rectlist->rl_head; 

rectnode; rectnode = rectnode->rn_next) { 

rl_rectoffset(rectlist, &rectnode->rn_rect, 
&rect); 

/* draw a square around this rect */ 

xO “ rect.r_left; 

xl = rect_right(&rect) ; 

yO = rect.r_top; 

yl = rect_bottom(Srect); 

pw_vector(win, xO, yO, xO, yl, PIX_SET, 1); 
pw_vector(win, xO, yl, xl, yl, PIX_SET, 1); 
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} 


pw_vector(win, xl, yl, 
pw_vector(win, xl, yO, 


xl, yO, PIX_SET, 1) ; 
xO, yO, PIX_SET, 11 ; 


/* done, so unlock, clear flag, and undo rectlist */ 
pw_unlock(win) ; 

gfx->gfx_flags &= ~GFX_DAMAGED; 
pw_donedamaged(win); 


/* give the user some idea what to do */ 
vertical_line += 20; 

if (vertical__line > height) vertical_iine = 20; 
pw_text(win, 20, vertical_line, PIX_SRC, NULL, 

"Put windows on this window, and then take them off!" 


#ifndef lint 

static char sccid[] = ”@(#)layout.c 2.0 85/05/20 Copyr 1985 Sun Micro"; 
#endif 

This program illustrates how to defeat the default tiling 
algorithm, which as of 2.0 leaves much to be desired. A major 
problem is that you can’t lay out subwindows in a tool like this: 




Section 6.2.5 of the SunWindows Reference Manual says 
that what you need to do is write your own routine named 
tool_layoutsubwindows(tool). At link time, this routine will 
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supersede the routine provided in the suntool.a library. The 
user-supplied version should set up rects to describe the desired 
layout (one rect per subwindow), and enforce the rects with calls 
to win_setrect, which is documented in section 4.3. 

The only tricky part is figuring out what the coordinates 
and sizes (which you put in the rects) refer to: should you or 
should you not figure in the borders? Here’s the low-down. The 
Width and height of the tool (specified in tool_make) include the 
top namestripe (16 pixels) and the top, left, bottom, and right borders 
(5 pixels each: 2 black, then 1 white, then 2 more black). Moreover, 
in order for things to look right, there should be 5 pixels in _ 
between all subwindows. All coordinates are relative to the top-left 
corner of the tool (i.e. the first pixel in the namestripe); 
dimensions do NOT include borders. Thus the first subwindow goes 
at (5,18). 

Note that instead of using explicit values for the size of the 
namestripe, border width, and spacing, we could have used the 
functions tool_stripeheight (), tool__borclerwidth () FP, and 
tool_subwindow_spacing(). These are described in section 6.2.5 of 
the 

SunWindows Reference Manual. 

To compile: 

cc layout.c -o layout -Isuntool -Isunwindow -Ipixrect 
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f'include <stdio.h> 

#include <suntool/tool_hs.h> 
♦include <suntool/msgsw.h> 

struct tool *tool; 

struct toolsw *swl, *sw2, *sw3; 

struct pixfont *font; 


/* The tool. */ 

/* The subwindows. */ 

/* Font for writing in subwins. */ 


Routine to handle SIGWINCH. Nothing special. */ 
sigwinchcatcher() 

{ 

tool_sigwinch(tool) ; 

} 


main(argc,argv) 
int argc; 
char **argv; 

{ 

/* Create the tool. */ 

tool = tool_make(WIN_LABEL, argv[0], 

WIN_WIDTH, 500, 

WIN_HEIGHT, 428, 

0 ) ; 

if (tool == NULL) { 

printf("Aborting: cannot create tool.O); 
exit(1); 

}; 


font = pw__pf sysopen 0 ; 

/* Create 3 subwindows. Dimensions don't matter, since we're */ 
/* going to override them and the tiling algorithm. */ 

swl = msgsw_createtoolsubwindow(tool, 

TOOL_SWEXTENDTOEDGE, 100, 

"This is the first subwindow.", font); 

sw2 = msgsw_createtoolsubwindow(tool, , 

TOOL_SWEXTENDTOEDGE, 100, 

"This is the second subwindow.", font); 

sw3 = msgsw_createtoolsubwindow(tool,"", 

TOOL_SWEXTENDTOEDGE,TOOL_SWEXTENDTO£DGE, 

"This is the third subwindow.”, font); 

if (swl==NULL I I sw2==NULL I I sw3==NULL) { 

printf("Aborting: cannot create subwindows.0); 
exit (2); 
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/* Install the tool */ 

"signal(SIGWINCH, sigwinchcatcher); 
tool_install(tool); 

/* Main loop. */ 
tool_select(tool,0); 

/* Clean up */ 
tool_destroy(tool) ; 
exit(0); 


This is our customized version of the layout algorithm. All 
we do is format rects to tell the subwindows where we really 
want them to go. 

tool_layoutsubwindows(t) 
struct tool *t; 



} 


struct rect recti, rect2, rect3; 

rectl.r_left = 5; 
rectl.r__top = 18; 
recti.r_width = 100; 
recti.r_height = 200; 

win_setrect(swl->ts_windowfd, Srectl); 

rect2.r_left = 5; 

rect2,r_top = 223; 

rect2.r_width = 100; 

rect2.r_height = 200; 

win_setrect(sw2->ts_windowfd, &rect2); 

rect3.r_left = 110; 

rect3.r_top = 18; 

rect3.r_width = 385; 

rect3.r_height = 405; 

win_setrect(sw3->ts windowfd, &rect3); 


#ifndef lint 

static char sccid[] = "@(#)onewaytomakeacolorbar.c 2.0 85/05/20 Copyr 1985 Sun M; 
#endif 
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colormap experimentation — how to manipulate colormap and bit- 
planes 

This program draws 2**n bars of different colors (0 <= n <= 8). It 
loads a gray-scale-colormap, enables all the bit-planes it needs for 
the number of bars it is about to draw, and then draws the bars. 

Remember, in the window system, all colors will show up in any given 
window only when the mouse is in that window. 
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To compile: 

cc onewaytomakeacolorbar.c -o onewaytomakeacolorbar -Isuntool -Isunwindow -Ipixi 

#include '<stdio.h> 

#include <suntool/tool_hs.h> 

#include <suntool/gfxsw.h> 

main(argc/ argv) 
int argc; 
char **argv; 


struct gfxsubwindow *gfx = gfxsw_init(0, argv); 
struct pixwin *win = gfx->gfx__pixwin; 
unsigned char red[256], green[256], blue [256]; 
int colors, i, height, width, planes; 
char maps[20]; 

for (;;) ( 

for (colors=2; colors<257; colors *= 2) { 

printf("Number of colors: %d0, colors); 
planes = colors-1; 

/* generate a colormap with 'colors' entries where the 
0th entry is black and the color'th entry is white 
with a gray scale in the intervening values*/ 
for (i=0; i<colors; i++) { 

red[i] = green[i] = blu6[i] = i*255/(colors-1); 

} 

/* find the dimensions of the rect */ 
height = win__getheight (gfx->gfx_windowfd) ; 
width = win_getwidth(gfx->gfx_windowfd); 

/* make up a colormap name and load it */ 
sprintf(maps, "testcolorld”, colors); 
pw_setcmsname(win, maps); 

/* put in the colormap we made above */ 
pw_putcolormap(win, 0, colors, red, green, blue); 

/* enable all the bit-planes used */ 
pw_putattributes(win, Splanes); 

/* clear the window */ 

pw_write(win, 0, 0, width, height, PIX_CLR, NULL, 0, 0); 

/* determine the width of the colorbars */ 
width /= colors; 
if (width < 1) width = 1; 

/* draw the colorbars — one for each color we're displaying */ 


Revision G of 3 October 1985 


H-15 





onewaytomakeacolorbar.c 


SunWindows Examples 


) 

} 


for 


) 


(i=0; i<colors; i++) { 

pw_write (win, i*wid.th, 0, width, height, 
PIX SRCIPIX COLOR{i), NULL, 0, 0); 



sleep(3); 

/* make and insert the inverse colormap of the first one ■ 
we made */ 

for (i=0; i<colors; i++) ( 

red[i] = green[i] = blue[i] = 255 - (i*255/(colors-1)); 

1 

pw_putcolormap(win, 0, colors, red, green, blue); 
sleep (3); 


#ifndef lint 

static char sccid[] = "@(#)anotherwaytomakeacolorbar.c 2.0 85/05/20 Copyr 1985 Si 
#endif 


colormap experimentation -- another way to manipulate colormap and bit-planes 

This program draws 2**n bars of different colors (0 <= n <= 8). It 

loads a gray-scale colormap and then draws the colorbars. In this 

version, the programs tries to write to all the bit-planes each time 

it writes a bar. However, before it writes the bar, it only enables 

the proper set of bit-planes for the color it wants to draw. 

Remember, in the window system, all colors will show up in any given 
window only when the mouse is in that window. 
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To compile: 

cc anotherwaytomakeacolorbar.c -o anotherwaytomakeacolorbar -Isuntool -isunwind< 

#include'<stdio.h> 
finclude <suntool/tool_hs.h> 

#include <3untool/gfxsw.h> 

main(argc, argv) 
int argc; 
char **argv; 


struct gfxsubwindow *gfx = gfxsw_init(0, argv); 
struct pixwin *win = gfx->gfx_pixwin; 
unsigned char red[256], green[256], blue [256]; 
int colors, i, height, width, planes; 
char maps[20]; 

for (;;> { 

for (colors=2; colors<257; colors *= 2) { 

printf("Number of colors: %d0, colors); 
planes = colors-1; 

/* generate a colormap with 'colors' entries where the 
0th entry is black and the color'th entry is white 
with a gray scale in the intervening values*/ 
for (i=0; Kcolors; i++) { 

red[i] = i*255/(colors-1); 

green [i] = 255 - ■ (i*255/(colors-1)); 

blue[i] = 250; 

} 

/* find the dimensions of the rect */ 
height = win_getheight(gfx->gfx_windowfd); 
width = win_getwidth(gfx->gfx_windowfd); 

/* make up a colormap name and load it */ 
sprintf(maps, "testcolorld", colors); 
pw_setcmsname(win, maps); 

/* put in the colormap we made above */ 
pw_putcolormap(win, 0, colors, red, green, blue); 

/* enable all the bit-planes used */ 
pw_putattributes(win, &planes); 

/* clear the window */ 

pw_write(win, 0, 0, width, height, PIX_CLR, NULL, 0, 0); 

/* determine the width of the colorbars */ 
width /= colors; 
if (width < 1) width = 1; 
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/* draw the colorbars — one for each color we're displaying 
Note: this time we write out to all the bit-planes with 
the pw_write0 call, but we only enable some of the 
bit-planes. This is a different way of making colors */ 
for (i=0; Kcolors; i++) { 

planes = i; 

pw_putattributes(win, splanes); 
pw_write(win, i*width, 0, width, height, 

PIX_SET, NULL, 0, O') ; 

} 

sleep(3); 

/* make and insert the inverse colormap of the first one 
we made */ 

for (i=0; ikcolors; i++) { “ 

red[i] = 255 - (i*255/(colors-1)); 
green[i] = i*255/(colors-1); 
blue[i] = 250; 

} 

pw_putcolormap(win, 0, colors, red, green, blue); 
sleep(3); 


} 

} 

} 

#ifndef lint static char sccid[] = "(§)(#)animation.c 2.0 85/05/20 Copyr 1985 Sun Micro"; #endif 

Copyright (c) 1985 by Sun Microsystems, Inc. 

Move a square around the screen randomly - a random walk 

This program uses "animation", a technique of displaying one bit-plane while 
drawing to another. This gives the appearance of smooth change from one 
image to the next. You can sort of see what animation looks like without 
multiple bit-planes if you run this program on a monochrome display. 

A good exercise, however, is to modify this program slightly to use only 
one bit-plane so you can see the difference between smooth multi-plane 
and jumpy single-plane animation. 
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To compile: 

machine% cc animation.c -o animation -Isuntool -Isunwindow -Ipixrect 


#include <stdio.h> 

♦include <suntool/tool_hs.h> 

♦include <suntool/gfxsw.h> 

♦define RECTX 20 
♦define RECTY 35 

/* declare all the functions we use to generate random walk */ 
long random0, getpidO; 
int srandomO; 

main(argc, argv) 
int argc; 
char **argv; 

{ 

int posx, posy; 

int old_posx, old__posy; 

int planes; 

int height, width; 

♦define BCKRND 230 
♦define BCKGRND BCKRND^10 

/* set up two color maps, redO, greenO, blueO, and redl, greenl, 
bluel */ 

static unsigned char red0[4] = {0, BCKRND, 0, BCKRND}; 

static unsigned char green0[4] = {0, BCKRND, 0, BCKRND}; 

static unsigned char blue0[4] = {BCKGRND, BCKGRND, BCKGRND, BCKGRND}; 

static unsigned char redl[4] = (0, 0, BCKRND, BCKRND); 

static unsigned char greenl[4] = (0, 0, BCKRND, BCKRND); 

static unsigned char bluel(4] = {BCKGRND, BCKGRND, BCKGRND, BCKGRND); 

/* set up a graphics subwindow */ 

struct gfxsubwindow *gfx = gfxsw_init(0, argv); 

struct pixwin *win = gfx->gfx_pixwin; 

/* initialize the randomizing variable */ 
srandom( (int) (getpidO )) ; 

/* set the colormap name */ 
pw_setcmsname(win, "animate"); 

Restart: 

/* window size may have changed, so get current coordinates */ 
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width = win_getwidth(gfx->gfx_windowfd); 
height = win_getheight(gfx->gfx_windowfd); 
old_posx = posx = width/2; 
old_posy = posy = height/2; 

/* put in the redl, greenl, bluel colormap */ 
pw_putcolorinap (win, 0, 4, redl, greenl, bluel); 

/* clear the window */ 
planes =3; 

pw_putattributes(win, splanes); 

pw write{win, 0, 0, width, height, PIX_NOT(PIX_SRC), NULL, 0, 0); 

/* do some initialization */ 
planes = 1; 

pwjputattributes(win, fiplanes); 

pw_write(win, posx, posy, RECTX, RECTY, PIX_SRC, NULL, 0, 0); 
planes = 2; 

pw_putattributes(win, splanes); 

/* draw the thing zillions of times */ 
for (;;) { 

/* check for damage */ 

if (gfx->gfx_flag3&GFX_DAMAGED) gfxsw_handlesigwinch(gfx) 
if (gfx->gfx_flags&GFX_RESTART) { 

gfx—>gfx_flags &= ■GFX_RESTART; 
goto Restart; 

) 

/* draw the next square */ 

pw_write(win, posx, posy, RECTX, RECTX, PIX_SRC, NULL, 0, 

/* swap colormaps so the polygon just drawn shows and 
the polygon about to be drawn won't show */ 
if (planes == 2) { 

pw_putcolormap(win, 0, 4, redl, greenl, bluel); 
planes = 1; 

} else { 

pw_putcolormap(win, 0, 4, redO, greenO, blueO); 
planes = 2; 

} 

/* wipe out the old square */ 
pw_putattributes(win, Splanes); 

pw__write (win, old_posx, old_posy, RECTX, RECTX, 

PIX_N0T(PIX_SRC), NULL, 0, 0); 
oid_posx = posx; 
old_posy = posy; 

/* determine the next posx and posy */ 
if (randomO < 1073741824) { 

posx -= random()/268435456 + 1; 

} else { 
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posx += randomO 7268435456 + 1; 

} 

if (randoraO < 1073741824) { 

posy -= randomO 7268435456 + 1; 

} else { 

posy += randomO 7268435456 + 1; 

} 

if (posx < 0) posx = width-1; 
if (posx > width) posx = 0; 
if (posy < 0) posy = height-1; 
if (posy > height) posy = 0; 

} 

} 


#ifndef lint 

static char sccid[] = ”(3 (#)parse_all.c 2.0 85705720 Copyr 1985 Sun Micro" 
#endif 

This program illustrates correct use of the "tool_parse_all" 
call, which is used to extract tool-related command line options 
from argv. 

After we call "tool_parse_air', all parameters left in argv are 
suitable for parsing. All we do is concatenate them in a string 
which we display in a message subwindow. Note the use of 
"tool_free_attribute_list", which releases resources grabbed by 
"tool_parse_air’. 

To see the tool in action, type "parse_all", followed by several 
command line options. Some of these should be tool-related (see 
Table 6-2 on p. 6-10 of the SunWindows Reference Manual for a list); 
these will be filtered out by "tool_parse_air' and will affect the 
tool. The other options will be seen in the message subwindow (a 
serious tool would parse them). 
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Sample command line: 

parse_all -xxx -yyy -width 100 -zzz -height 30 
To compile: 



cc parse_all.c -o parse_all -Isuntool -Isunwindow -Ipixrect 


Copyright (C) 1985 Sun Microsystems Inc. 


♦include <stdio.h> 

♦include <suntool/tool_hs.h> 

♦include <suntool/msgsw.h> 

struct tool *tool; /* The tool */ 

struct toolsw *subwin; /* The subwindow */ 

struct pixfont *font; 
int sigwinchcatcher0; 


main(argc, argv) 
int argc; 
char *argv[]; 

{ 

char **tool_attributes = NULL; 
char *tool_name = argv[0]; 
char msg_string[80] ; 
argv++; 
argc—; 

if(tool_parse_all(&argc, argv, &tool_attributes, tool_name) 
tool_usage(tool_name); 
exit(1); 

} 

msg_string[0] = 0; 

while (argc >0 && **argv =='-') { 

strcat (msg__string, *argv) ; 
strcat(msg_string, " ”); 
argv++; 
argc—; 

} 



- 1 ) { 


/* Create the tool. */ 

tool = tool__make {WIN_LABEL, argv[0], 

WIN_ATTR_LIST, tool_attributes, 

0 ) ; 

if (tool == NULL) { 

fputs("Can't make the tool.O, stderr); 
exit(1); 

} 

tool_free_attribute_list(tool_attributes); 
font = pw_pfsysopen0; 

subwin = msgsw_createtoolsubwindow(tool,"", 

TOOL_SWEXTENDTOEDGE, TOOL_SWEXTENDTOEDGE, 
msg_string, font); 
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if (subwin == NULL) { 

fputsC'Can't make the subwindow.0, stderr) ; 
exit(1); 

) 

/* Install the tool */ 

signal(SIGWINCH, sigwinchcatcher); 

tool_install(tool); 

/* Main loop. */ 
tool_select(tool, 0) ; 

/* Clean up */ “ 

tool_destroy(tool) ; 
exit (0) ; 

} 


/* Standard SIGWINCH handler. */ 
sigwinchcatcher() 

{ 

tool_sigwinch(tool); 

} 


#ifndef lint 

static char sccid[] = ”8(#)findroot.c 2.0 85/05/20 Copyr 1985 Sun Micro" 
#endif 

This program illustrates how to find out what a tool’s 
root window’s file descriptor is. This is necessary, for example, 
if you want to use certain of the Window Manager calls which are 
documented in section 8.5.1 of the 1.1 SunWindows Reference Manual 
(section 9.6.1 of the 2.0 Manual). 

This program creates a tool with a single message subwindow. 

When the user clicks the right-hand mouse button, the wmgr^close 
call is used to shut the tool down to iconic form. 

The interesting part is the function get_my_root_fd(). See 
comments there for details. 


o 
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#include <stdio.h> 

#include <sys/file.h> 
#include Ountool/wmgr.h> 
♦include <suntool/tool_hs.h> 
♦include'<suntool/msgsw.h> 

struct tool *tool; 
struct toolsw *subwin; 
struct pixfont *font; 
struct inputmaslc inputmask; 
int subwin selected!); 


/* Routine to handle SIGWINCH. Nothing 
sigwinchcatcher() 

{ 

tool_sigwinch(tool); 

} 


o 


/* The tool. */ 

/* The single subwindow. */ 

/* Font for writing in the subwin. */ 
/* Input mask for the subwindow. */ 

/* "Selected" routine for subwin. */ 


special. */ 


main!) 

{ 

font = pw_pfsysopen(); 

/* create the tool. */ 

tool = tool_create("FINDROOT", 

TOOL_NAMESTRIPE1TOOL_BOUNDARYMGR, 

NULL, NULL); 
if (tool == NULL) { 

printf C'Couldn't create the tool.O); 
exit(1); 

}; 



/* Create and init the subwindow. */ 
subwin = msgsw_createtoolsubwindow(tool, 

TOOL_SWEXTENDTOEDGE, TOOL_SWEXTENDTOEDGE, 
"Click Right Button to go iconic.", font); 
if (subwin == NULL) { 

printf("Couldn't create the subwindow.0); 
exit(1); 

} ; 

/* Set up inputmask to accept only RB clicks. */ 
input_imnull(&inputmask); 

win_setinputcodebit(&inputmask,MS_RIGHT); 
win_setinputmask(subwin->ts_windowfd, sinputmask, 
NULL,WIN_NULLLINK); 

subwin->ts_io.tio_selected = subwin_selected; 

/* Install the tool. */ 

signal(SIGWINCH, sigwinchcatcher); 

tool install(tool); 
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/* Main loop. */ 
tool_select(tool, 0) ; 

/* Cleanup. */ 
-tool_destroy(tool) ; 
exit(0); 


If we get here, the user must have clicked the right-hand 
mouse button. This routine calls get_my_root_fd() to figure out 
the file descriptor of its root window, then calls wmgr_close() 
to close the tool to icon form. 

/ 

subwin_selected() 

{ 

struct inputevent ie; 
char c[WIN_NAMESIZE3; 
int rootfd; 

input_readevent(subwin->ts_windowfd, &ie); 
rootfd = get_iny_root_fd(tool->tl_windowfd) ; 
if (rootfd === -1) { 

printf("get_my_root_fd() failed.0); 
exit(3); 

) 

vnT\gr_close (tool->tl_windowfd, rootfd) ; 

} 

This is the interesting part of the program. This function 
takes as its argument the file descriptor for a window, and returns 
the file descriptor of the argument’s root window (or -1 if something 
goes wrong). See section 4.4 of the SunWindows Reference Manual for 
details on the window hierarchy. 

The strategy is to recursively call win_getlink, working our way 
up the window tree, until we get to the top (i.e. win_getlink returns 
WIN_NULLLINK). The only problem is that win_getlink returns a window 
number, not a file descriptor. To convert the window number to a file 
descriptor, we first call win_numbertoname, which converts the window 
number to a string such as ’7dev/win3". Then we open the device in 
order to get a file descriptor. 
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get_iny_root_f d (f d) 
int fd; 

{ 

^int original_fd, parentfd; 
char c[WIN_NAMESIZE3; 

original_fd = fd; 

while { (parentfd = win_getlink(fd,WL_PARENT)) != WIN_NULLLINK ) { 

if (fd != original_fd) 
close(fd); 

win_nuinbertonaine (parentfd, c) ; 
fd = open(c,O_RDONLY,0); 
if (fd == -1) 

return(-1); 

) 

return(fd); 
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